Update: Neues Repo in den Wald-Vektor einbinden

Kurz-Antwort auf die wiederkehrende Frage "wie kommt ein Repo ins Dashboard/Chat?"
— damit sie nicht wieder verloren geht.

Wo

forest_seed.py auf backbone (/opt/crumbforest/forest/forest_seed.py).
Zieht Repos aus Gitea, chunked Markdown/Skripte, embedded (fastembed,
all-MiniLM-L6-v2), schreibt nach forest_memory (pgvector, DB crumbforest_db).
Reine Python-Pipeline — kein Bash-Collector nötig (anders als der
qdrant-Collector auf nullfeld).

Schritt 1: Repo in REPO_MAP eintragen

forest_seed.py seedet nur Repos, die im hardcodierten REPO_MAP-Dict
stehen. Fehlt der Eintrag → Unbekanntes Repo, exit 1 (kein Hänger, bewusster Guard).

REPO_MAP = {
    # ── Admin / Infra → Deepbit ──
    ...
    'Ansible-Crumbforest': {'tag': 'admin', 'desc': 'Ansible Playbooks & NetBox Infra-Automation'},
}

Tag steuert die Persona-Sichtbarkeit:

Schritt 2: Seeden

DB-Passwort steht in /etc/crumbforest/secrets.env (FOREST_PASS), wird
nicht automatisch geladen — vorher sourcen:

cd /opt/crumbforest/forest
set -a && source /etc/crumbforest/secrets.env
export FOREST_USER=crumbforest FOREST_DB=crumbforest_db FOREST_HOST=127.0.0.1 FOREST_PORT=5432
/opt/crumbforest/venv/bin/python3 forest_seed.py --repo <RepoName>

Nützlich zum Nachschauen: forest_seed.py --list (zeigt REPO_MAP),
--dry-run (nur Dateien listen, nichts schreiben).

Caveat: kein Auto-Pull

clone_or_pull() in forest_seed.py macht git pull über HTTPS —
backbone hat keinen Credential-Helper für git.crumbforest.org
(fatal: could not read Username ... terminal prompts disabled).
Ein bereits vorhandener Checkout in /opt/crumbforest/repos/<repo> wird
also beim Seed-Lauf NICHT automatisch aktualisiert; der Pull-Fehler wird
nur gewarnt, nicht hart abgebrochen. Für frische Commits: Checkout vorher
manuell aktualisieren (oder SSH-Remote/Token einrichten — offen).

Erkenntnis (2026-07-02): doktor.sh vs. Ansible — Source of Truth

*-doktor.sh-Skripte (backbone-doktor.sh & Co.) bleiben read-only
Schnappschüsse — gut zum schnellen Draufschauen, aber jedes Skript kennt
nur sich selbst. Ansible (dieses Repo) ist die Source of Truth für
Soll-Zustand und Automation; doktor.sh bleibt Diagnose-Werkzeug, nicht
Steuerung. Bei Widerspruch zwischen doktor.sh-Ausgabe und Ansible-Facts/
Playbooks gewinnt Ansible.