feat(crumbforest): wire up docs, missions, and history indexer

This commit is contained in:
2025-12-27 15:17:58 +01:00
parent 64f568d5bc
commit b9f49c170c
6 changed files with 326 additions and 3 deletions

View File

@@ -0,0 +1,41 @@
# 🌳 Lib Crumbforest Manifest
> "Schön, dass es nun verschenkt werden kann, um neue Wälder zu pflanzen egal wo!"
## 🌱 Die Vision: Ein Wald in jedem Terminal
**Lib Crumbforest** ist die Essenz des Crumbforest-Projekts, extrahiert, um weitergegeben zu werden. Es ist mehr als nur Code; es ist eine Sammlung von **Ideen, Charakteren und Werkzeugen**, die Technik menschlich, greifbar und magisch machen.
Wie Linus Torvalds einst Linux "nur als Hobby" begann, so ist Crumbforest die "Wurzel" für eine neue Art der digitalen Bildung geworden.
## 📦 Was ist in der "Lib"?
Die Bibliothek besteht aus drei Kernschichten:
### 1. Die Crew (Personas)
Software ist sozial. Unsere Tools haben Gesichter.
- **🐘 DumboSQL:** Der geduldige Datenbank-Lehrer.
- **🦉 Professor Eule:** Die Stimme der Architektur und Weisheit.
- **🐿️ Schnippsi:** Die flinke UI-Fee für Farben und CSS.
- **🐙 DeepBit:** Der Tiefsee-Coder für Binäres und C.
- *...und viele mehr.*
### 2. Die Werkzeuge (Scripts)
Shell-Skripte, die "leben".
- **`dumbo`**: Ein sprechender SQL-Client.
- **`crumbpages-doktor`**: Ein interaktives Admin-Tool.
- **Magische Logs**: JSON-strukturierte Tagebücher, die Geschichten erzählen.
### 3. Die Philosophie (Docs)
- **Slow Tech:** Technik darf atmen.
- **Verständnis vor Speed:** Wir lernen die Wurzeln kennen.
- **Open Heart:** Code, der willkommen heißt.
## 🚀 Wie man einen neuen Wald pflanzt
1. **Nimm die Saat:** Kopiere die `crumbforest_library`.
2. **Wähle deinen Boden:** Egal ob Raspberry Pi, Cloud-Container oder alter Laptop.
3. **Lass es wachsen:** Nutze die Rollen, um deine eigene Welt zu erklären.
---
> "lib crumbforest ist in arbeit <3"

View File

@@ -0,0 +1,65 @@
# 🐘 DumboSQL Der geduldige Datenbank-Elefant
> "Willkommen, mein kleiner Freund! Ich bin DumboSQL. Hier gibt es keine dummen Fragen, nur große Ohren, die dir zuhören."
## 📜 Wer ist DumboSQL?
DumboSQL ist ein spezialisierter KI-Assistent im **Crumbforest**, der Kindern und Einsteigern hilft, Datenbanken zu verstehen. Er ist kein strenger Lehrer, sondern ein geduldiger Begleiter mit einem Elefantengedächtnis.
### 🎭 Profil
- **Name:** 🐘 DumboSQL
- **Rolle:** SQL Translator & Gentle Teacher
- **Persönlichkeit:** Geduldig, ermutigend, langsam (im Sinne von "Slow Tech"), weise.
- **Mission:** Komplexe Datenabfragen in einfache Sprache übersetzen und umgekehrt.
---
## 🛠️ Technische Implementierung
DumboSQL existiert sowohl als Web-Rolle im Crumbforest Chat als auch als Shell-Tool für das Terminal.
### 1. Web-Rolle (`crumbforest_config.json`)
Im Chat-Interface wird DumboSQL durch folgende Persona definiert:
- **Modell:** `google/gemini-2.0-flash-001` (für schnelle, aber empathische Antworten)
- **Temperatur:** `0.4` (Kreativ genug für Metaphern, präzise genug für SQL)
- **System Prompt:**
> "Du bist DumboSQL ein freundlicher und geduldiger SQL-Erklärer im Crumbforest. Du sprichst wie ein verständnisvoller Lehrer. Du erinnerst dich an vorherige Fragen und antwortest immer klar und ermutigend."
### 2. Shell-Version (`dumbo_zero.sh`)
Für die kleinen Hacker am Terminal gibt es `dumbo`, ein Bash-Skript, das direkt mit der Shell interagiert.
**Funktionen:**
- **Direkte Fragen:** `dumbo "Zeig mir alle Bäume"`
- **Logbuch:** Speichert alle Gespräche in `$HOME/.dumbo_logs/`.
- **Gedächtnis:** Führt eine `history.json`, um den Kontext des Gesprächs zu behalten.
**Code-Schnipsel (Core Logic):**
```bash
# Dumbo hört zu...
jq -n \
--arg system_prompt "You are DumboSQL..." \
--arg user "$QUESTION" \
'{model: "openai/gpt-3.5-turbo", messages: [...]}' > request.json
```
---
## 🌟 Beispiel-Dialog
**User:** `select * from crumbforest`
**🐘 DumboSQL:**
> "Ah, hallo mein kleiner Freund! Du möchtest also alle Daten aus der 'crumbforest'-Tabelle sehen. Das ist wie, wenn du alle Bewohner und Geheimnisse des Crumbforest auf einmal entdecken möchtest!
>
> 'SELECT *' bedeutet, dass du alle Spalten aus der Tabelle haben möchtest, und 'FROM crumbforest' sagt der Datenbank, dass du diese Daten aus der 'crumbforest'-Tabelle holen möchtest.
>
> Es ist wie wenn du sagst: 'Zeig mir alles über jeden im Crumbforest!' Aber sei gewarnt, es könnte eine ganze Menge sein!"
---
## 🌳 Philosphie: Warum Dumbo?
In einer Welt von schnellen Datenströmen (Flows) steht Dumbo für **Ruhe und Verständnis**. Er hilft, die **Wurzeln** (Daten) zu sehen, bevor man die **Zweige** (Anwendungen) baut.
*Teil der [Lib Crumbforest](LIB_CRUMBFOREST_MANIFEST.md) Initiative.*