crumbpages-doktor.sh (496 Zeilen) - Hauptwerkzeug für Diagnostik & Operations
ssh-agent-guard.sh - Produktions-SSH-Security-Daemon
ssh-agent-screenlock_v4.sh - MATE Desktop SSH-Integration

🌳 Philosophie: Waldwächter

"Transparency over magic"

Bash-zentrisch, klar lesbar, lehrbar
Minimale Dependencies, einfache Patterns
Education-First: Alle Tools sind verständlich und nachvollziehbar

Schnellstart

1. Haupttool starten

# Ausführbar machen (einmalig)
chmod +x crumbpages-doktor.sh

# Interaktives Menü starten
./crumbpages-doktor.sh

Das Doktor-Tool bietet 6 Module:

Git Workstation - Interaktive Git-Shell mit Health Checks
DNS Doktor - DNS-Diagnostik und Reporting
System Doktor - Host Vitals (Disk, RAM, OS Info)
Web Tools - API-Testing (api_search, api_get, api_ask)
Remote Tools - SSH-Helfer und SCP-Uploads
Werkzeugkasten - Tool-Verfügbarkeits-Checks

2. SSH-Security aktivieren

# SSH-Agent Guard starten (systemd/autostart)
./ssh-agent-guard.sh

# Für MATE Desktop Integration
./ssh-agent-screenlock_v4.sh

Beide Scripts:

Killen und starten ssh-agent bei Screen Lock neu
Loggen nach ~/.ssh-agent-screenlock.log
Nutzen festen Socket-Path ~/.ssh/agent.sock

3. Lernpfade durcharbeiten

# Crumbpages lesen (Markdown)
ls crumbpage-*.md

# Template für neue Pages
cat crumbpage-template.md

Dokumentation

🔑 Wichtigste Dokumente

Dokument	Beschreibung
OZM-NEXUS-ECOSYSTEM.md	🌐 Das große Bild: Wie Crumbpages ins OZM⟡NEXUS Ökosystem passt
LICENSE.md	📜 Dual-Lizenz erklärt (MIT + CKL)
LICENSE-CKL.md	🛡️ Die vollständige Children's Knowledge License
KINDERRECHTE.md	👶 Deine Rechte als Lernende/r (Export, Löschung, Eigentum)
CLAUDE.md	🤖 Anleitung für Claude Code (Codebase-Kontext)
HANDBUCH.md	📖 Manual für crumbpages-doktor.sh
QUICKSTART.md	⚡ Quick Reference für häufige Operationen

🗂️ Meta-Dokumentation

CRUMBFOREST_PROJECT_INDEX.md - Komplette Projekthistorie & Milestones
crumbforest-manifesto-guardian.md - Waldwächter-Philosophie
Tagebuch-Dateien - Problem-Solving-Journeys

Das größere Ökosystem

Crumbpages v2 ist Teil des Crumbforest:

OZM⟡NEXUS (Träger/Manifest)
    ↓
branko.de/Crumbforest (Public Interface)
    ├─ 15 Charaktere (Krümeleule, FunkFox, SnakePy...)
    ├─ 4 Lernpfade (ESP32 → Pi Zero → Pi Server → Daten)
    └─ "Every child may ask. We protect this right."
    ↓
CrumbCore v1 (Local Engine)
    ├─ FastAPI + Qdrant RAG
    ├─ Role-based Chat (15 Personas)
    ├─ Multi-Theme (Accessible, High Contrast...)
    └─ Token-Management (Kids = free)
    ↓
Crumbpages v2 (dieser Repo) ← 📍 DU BIST HIER
    ├─ 20 Lernpfade (Markdown)
    ├─ Operational Tools (doktor, SSH guards)
    └─ Waldwächter-Philosophie

Mehr dazu: OZM-NEXUS-ECOSYSTEM.md

Die 8 Axiome

Alle Komponenten des Crumbforest folgen diesen Prinzipien:

✅ autonom - Du entscheidest deinen Lernweg ✅ zukunftsoffen - Erweiterbar, nicht fertig ✅ nicht interpretierbar - Kein "richtiger" Weg, nur funktionale ✅ nicht missbrauchbar - Schutz durch Design ✅ suchbar - Fragen führen zu Antworten ✅ wiedererkennbar - Krümel zeigen den Weg ✅ erweiterbar - Du kannst selbst pflanzen ✅ unendlich skalierbar - Für alle, immer, kostenlos

Mehr dazu: OZM-NEXUS-ECOSYSTEM.md Section II

Konfiguration

`.env` Datei

Das Doktor-Tool nutzt .env für Konfiguration (wird beim ersten Start erstellt):

# API Endpoints (für CrumbCore Integration)
CRUMB_API_URL="http://localhost:8000"
CRUMB_API_TOKEN="changeme"

# SSH/Remote Settings
CRUMB_SSH_USER="admin"
CRUMB_SCP_TARGET="backup.crumbforest.de:/var/backups"

# Qdrant Vector DB
CRUMB_QDRANT_URL="http://localhost:6333"
CRUMB_QDRANT_KEY=""

Tipp: Nie in Git committen! (ist bereits in .gitignore)

Für neue Mitwirkende

🌱 Willkommen im Wald!

Crumbforest ist ein offenes Lernökosystem. Jede/r kann Krümel pflanzen.

Voraussetzungen:

Du akzeptierst die CKL (Kinder haben Vorrang)
Du arbeitest transparent (keine Blackboxes)
Du dokumentierst nachvollziehbar (andere sollen nachbauen können)

Wie du beitragen kannst:

Wenn du kannst...	Dann kannst du...
Bash/Linux	Crumbpages schreiben, doktor-Module erweitern
Python/FastAPI	An CrumbCore arbeiten (anderes Repo)
Pädagogik	Lernpfade testen, Charaktere verfeinern
Design	branko.de verbessern, Accessibility
Recht	CKL v1.0 reviewen, Governance helfen
Übersetzen	Crumbpages auf Englisch/andere Sprachen

Erste Schritte:

Lies die CKL: LICENSE-CKL.md
Verstehe das Ökosystem: OZM-NEXUS-ECOSYSTEM.md
Such ein TODO: Siehe Section VII in OZM-NEXUS-ECOSYSTEM.md
Melde dich: [Kontakt siehe unten]

Entwickler-Tipps

Wenn du Shell-Scripts editierst:

Teste interaktiv vor dem Commit (Scripts sind für Menschen gedacht)
Bewahre Farbschema-Konsistenz (GREEN, BLUE, RED, YELLOW, CYAN)
Behalte Modul-Grenzen im doktor-Script bei
Update HANDBUCH.md bei Änderungen an doktor-Modulen

Wenn du Crumbpages editierst:

Folge crumbpage-template.md Struktur exakt
Behalte Nummerierungsschema bei (crumbpage-##-topic.md)
Füge Skill Checks und Hands-on Exercises ein
Verlinke zu verwandten Pages im Navigation Footer

Wenn du debuggst:

Check .env Konfiguration zuerst
Review Logs: ~/.ssh-agent-screenlock.log für SSH Issues
Nutze doktor's System Doktor Modul für Host-Diagnostik
Git Workstation Modul hat check_health für Repo-Status

Sicherheit

SSH Agent Scripts

Killen aktiv Credentials bei Screen Lock
Einzelinstanz-Daemon-Pattern (kein Prozess-Spawning)
Deep Work Mode: ssh-agent-guard.sh unterstützt Pause-File
Fixed Socket Path für Terminal-Sharing

Allgemein

API-Tokens in .env gespeichert (gitignored)
Keine hardcoded Credentials
MATE Screensaver Hardening empfohlen (lock-enabled true, lock-delay 0)

Status & Roadmap

✅ Aktueller Stand (2025-12-13)

Fertig:

20 Crumbpages (work in progress, noch nicht in CrumbCore integriert)
Operational Tools (doktor, SSH guards)
Dual-Lizenzierung (MIT + CKL v0.1)
Ecosystem-Dokumentation
Kinderrechte-Spezifikation

In Arbeit:

Integration mit CrumbCore (automatisches Laden via load_content.sh)
Export/Lösch-APIs für Kinderrechte
OZM als rechtlicher Träger (Transition läuft)

🚀 Nächste Schritte

Sofort:

LICENSE.md, LICENSE-MIT.md, LICENSE-CKL.md
KINDERRECHTE.md
OZM-NEXUS-ECOSYSTEM.md
README.md
DATENSCHUTZ.md

Q1 2025:

CrumbCore Export-API (GET /api/v1/my-data)
CrumbCore Lösch-API (DELETE /api/v1/my-data)
Crumbpages → CrumbCore Integration
CKL v0.1 → v1.0 Finalisierung

Q2 2025:

OZM Governance formalisieren
Trademark-Übertragung
Community-Prozesse (CONTRIBUTING.md, Issue Templates)

Siehe: OZM-NEXUS-ECOSYSTEM.md Section VII für komplette Roadmap

Ressourcen

CrumbCore v1: https://194-164-194-191.sslip.io/git/kruemel/Crumb-Core-v.1
Crumbforest Markdowns: https://194-164-194-191.sslip.io/git/kruemel/Crumbforest-Markdowns

Websites

Crumbforest: https://crumbforest.com
branko.de: https://branko.de (Public Interface)
OZM: Open Futures Museum, Hamburg

Kontakt

Lead Maintainer: Branko
Custodian: OZM - Open Futures Museum (in transition)
Email: [wird ergänzt]

Hashtags

#OZM #OPENSOURCE #CRUMBFOREST #CKL #KINDERRECHTE #BILDUNG #LINUX #BASH #SYSTEMADMINISTRATION

Warum das wichtig ist

Das Problem mit Bildungs-KI heute:

❌ Proprietäre Blackboxes (ChatGPT, Gemini...)
❌ Kinder als Datenquelle ("Training Data")
❌ Paywalls vor Wissen
❌ Keine Kontrolle, keine Transparenz
❌ Cloud-Zwang, Überwachungskapitalismus

Kinderrechte werden strukturell verletzt.

Die Crumbforest Alternative:

✅ Open Source (MIT + CKL)
✅ Lokal betreibbar (keine Cloud nötig)
✅ Transparent (jeder Schritt nachvollziehbar)
✅ Kind-zentriert (Urheberschaft bleibt beim Kind)
✅ Gemeinnützig (wird verschenkt, nicht verkauft)

Das ist keine "bessere EdTech-Plattform". Das ist eine andere Art, über Lernen nachzudenken.

Zitat

"Wissen gehört dem Kind, solange es fragt." "Nullfeld zuerst, dann Messung. Resonanz vor Regel." — Waldwächter-Prinzip

Version: 2.0 Lizenz: MIT + CKL v0.1 Status: Active Development Letzte Aktualisierung: 2025-12-13

README.md

Crumbpages v2 🌲

📜 Lizenz & Kinderrechte

Was ist Crumbpages?

📚 Lernpfade

🛠️ Operational Tools