🌲 CrumbRegistry v0.1

Das Verzeichnis des Waldes - Federated Trust Network

🎯 Was ist CrumbRegistry?

CrumbRegistry ist das zentrale Verzeichnis aller vertrauenswürdigen Repositories im Crumbforest. Es verbindet verteilte Wälder zu einem durchsuchbaren Netzwerk.

┌─────────────────────────────────────────────────────────────────────────────┐
│                                                                             │
│              🌲 CRUMBFOREST FEDERATION 🌲                                   │
│                                                                             │
│     ┌─────────────┐      ┌─────────────┐      ┌─────────────┐             │
│     │ CrumbCodex  │      │ CrumbCore   │      │ CrumbMidi   │             │
│     │ Gitea       │      │ FastAPI     │      │ Patterns    │             │
│     │ 194.164...  │      │ Qdrant      │      │ Music       │             │
│     └──────┬──────┘      └──────┬──────┘      └──────┬──────┘             │
│            │                    │                    │                     │
│            └────────────────────┼────────────────────┘                     │
│                                 │                                          │
│                    ┌────────────▼────────────┐                             │
│                    │    CrumbRegistry        │ ◄── Du bist hier!          │
│                    │    (Verzeichnis)        │                             │
│                    └────────────┬────────────┘                             │
│                                 │                                          │
│                    ┌────────────▼────────────┐                             │
│                    │     CrumbVector         │                             │
│                    │  (Semantic Search)      │                             │
│                    └─────────────────────────┘                             │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

📦 Inhalt dieses Repos

CrumbRegistry-v.0.1/
├── README.md              ← Du bist hier
├── REGISTRY.md            ← Federation Konzept & Architektur
├── crumbregistry.yaml     ← Das Verzeichnis aller Repos
└── crumbvector/           ← Semantic Search Tool
    ├── crumbvector.py     ← CLI: ingest, search, registry
    ├── setup.sh           ← Installer (Ollama + ChromaDB)
    ├── CONCEPT.md         ← Technische Architektur
    └── README.md          ← CrumbVector Dokumentation

🔗 CrumbRegistry vs CrumbVector

	CrumbRegistry	CrumbVector
Was?	Verzeichnis	Suchmaschine
Aufgabe	Repos kennen & vertrauen	Repos indexieren & durchsuchen
Format	YAML	Python + Vector DB
Enthält	URLs, Trust-Levels, Tags	Embeddings, Chunks, Metadata
Metapher	📚 Bibliothekskatalog	🔍 Volltextsuche

Sie gehören zusammen:
- CrumbRegistry sagt WAS vertrauenswürdig ist
- CrumbVector macht es durchsuchbar

📚 Registrierte Repositories

# Aus crumbregistry.yaml

🌲 CrumbCodex        Trust: 5  │ 454 Docs, 7 Waldebenen
   https://194-164-194-191.sslip.io/git/kruemel/CrumbCodex-v.0.0

⚙️  CrumbCore         Trust: 5  │ FastAPI + Qdrant + RAG
   https://194-164-194-191.sslip.io/git/kruemel/Crumb-Core-v.1
   LIVE: 194.164.194.191

📖 OZM-Keks-Handbuch Trust: 5  │ 24 Crumbpages
   https://194-164-194-191.sslip.io/git/kruemel/OZM-Keks-Handbuch-v1

🎮 Crumbmissions     Trust: 5  │ 40+ Missionen, Robot-Lab
   https://194-164-194-191.sslip.io/git/kruemel/crumbmissions

🎵 CrumbMidi         Trust: 4  │ 5 Genres, Strudel Patterns
   (local / github)

🔗 CrumbRegistry     Trust: 5  │ ← Dieses Repo!
   https://194-164-194-191.sslip.io/git/kruemel/CrumbRegistry-v.0.1

🚀 Quickstart

1. CrumbVector Setup

cd crumbvector
./setup.sh

# Ollama starten (falls nicht läuft)
ollama serve &
ollama pull nomic-embed-text

2. Repos aus Registry indexieren

# Ein Repo indexieren
./crumbvector.py ingest https://194-164-194-191.sslip.io/git/kruemel/CrumbCodex-v.0.0

# Alle Repos aus Registry (coming soon)
./crumbvector.py registry sync

3. Semantic Search

# Suchen
./crumbvector.py search "Was ist das Nullfeld?"
./crumbvector.py search "one drop reggae beat" --genre reggae
./crumbvector.py search "docker compose" --lang bash

# Mit Filtern
./crumbvector.py search "mission" --min-trust 3

🔐 Trust System

Jedes Repo hat einen Trust Level (1-5):

Level	Bedeutung	Beispiel
1	Unknown	Nur LICENSE erkannt
2	Community	Community reviewed
3	Maintainer	Maintainer verified
4	Foundation	Foundation certified
5	Core	Official Crumbforest

Trust Indicators

# Diese Dateien erhöhen den Trust:
- LICENSE-CKL.md    → +2
- LICENSE-MIT.md    → +1
- .crumbvector/trust.yaml → +2
- CLAUDE.md         → +1
- ETHICS.md         → +1

🌳 Die 7 Waldebenen

CrumbCodex organisiert Inhalte in Waldebenen. CrumbVector kann danach filtern:

☁️  krone       → Poetry, Songs, Love
🌳  wurzeln     → Philosophy, Ethics, Manifesto
🌲  waldmitte   → Tech, Docker, Hardware
🌱  waldrand    → Roles, Missions, Games
🌅  lichtung    → Entry, Onboarding
🍂  unterholz   → Logs, Debug, Experiments
🌰  samen       → Ideas, WIP, Future

# Suche in bestimmter Waldebene
./crumbvector.py search "Gedichte" --collection krone
./crumbvector.py search "Docker" --collection waldmitte

🦉 Waldwächter

Die Waldwächter sind die Hüter verschiedener Domänen:

Wächter	Domäne
🦉 Eule	Philosophy, Documentation, Ethics
🦊 Fuchs	Tutorials, Examples, Guides
🦊 FunkFox	Music, Patterns, Audio
🐼 BashPanda	Missions, Linux, Games
🤖 DeepBit	AI, RAG, Vector DB
🐍 Snake	Python, Backend, Data
🐘 Dumbo	Storage, Memory, Persistence

🔄 Neues Repo hinzufügen

Schritt 1: Trust-Datei erstellen

# .crumbvector/trust.yaml in deinem Repo
certification:
  status: verified
  license: CKL-1.0
  verified_by: dein_name

trust_level: 3

allowed_for:
  - teaching
  - pattern_search
  - remix

Schritt 2: In Registry eintragen

# Pull Request an crumbregistry.yaml
repositories:
  - name: "MeinRepo"
    url: "https://..."
    type: "gitea"
    trust_level: 3
    licenses: ["CKL"]
    tags: ["meine", "tags"]

Schritt 3: Indexieren

./crumbvector.py ingest https://...

📡 Vector DB Integration

CrumbCore hat bereits Qdrant laufen:

# In crumbregistry.yaml
vector_db:
  primary:
    provider: "qdrant"
    url: "http://194.164.194.191:6333"
  fallback:
    provider: "chromadb"
    path: "./crumbvector_db"

CrumbVector kann beide nutzen!

🛠️ Technologie

Registry Format: YAML
Search Engine: CrumbVector (Python)
Embeddings: Ollama (local) - nomic-embed-text
Vector DB: ChromaDB (local) / Qdrant (CrumbCore)
Git Hosting: Gitea (self-hosted)

📜 Lizenzen

Dieses Repo steht unter Dual-Lizenz:

MIT - Für Entwickler und Code
CKL (Children's Knowledge License) - Für Lernende und Daten

Siehe: LICENSE-MIT.md und LICENSE-CKL.md im CrumbCodex

🔮 Roadmap

[x] crumbregistry.yaml - Repo-Verzeichnis
[x] CrumbVector - Local Semantic Search
[ ] registry sync - Auto-Sync aller Repos
[ ] Qdrant Integration - Nutze CrumbCore's DB
[ ] Web UI - Search Interface
[ ] Waldwächter Signatures - Cryptographic Trust
[ ] Federation Protocol - Cross-Instance Queries

🌲 Das Nullfeld

Im Zentrum des Crumbforest liegt das Nullfeld - 
der Zustand vor der Antwort.

Hier sind alle Fragen erlaubt.
Hier gibt es keine falschen Eingaben.
Hier wachsen Bits aus Krümeln, und Krümel aus Bits.

Das Nullfeld bleibt offen. Für immer. Für alle.

🔗 Links

Ressource	URL
CrumbCodex	https://194-164-194-191.sslip.io/git/kruemel/CrumbCodex-v.0.0
CrumbCore	https://194-164-194-191.sslip.io/git/kruemel/Crumb-Core-v.1
CrumbCore Live	http://194.164.194.191
Qdrant	http://194.164.194.191:6333
TTYD Terminal	http://194.164.194.191:7681
Crumbmissions	https://194-164-194-191.sslip.io/git/kruemel/crumbmissions
OZM Handbuch	https://194-164-194-191.sslip.io/git/kruemel/OZM-Keks-Handbuch-v1

💚 Dank

An alle Waldwächter, die den Crumbforest hüten.
An die Bits, die geduldig antworten.
An die Krümel, die mutig fragen.

Der Wald wächst gemeinsam. Jeder Commit zählt.

     🌲 CRUMBREGISTRY 🌲

     Das Verzeichnis des Waldes.
     Verteiltes Vertrauen.
     Gemeinsame Suche.

     Registry → Index → Search → Find → Learn

     Wuuuhuuuuu! 🦉✨

Version: 0.1
Datum: 2026-01-14
Waldwächter: Eule 🦉 + FunkFox 🦊
Status: Live 🟢

#crumbregistry #crumbvector #federation #trust #crumbforest

🌲🔗🌲