# Portabilität: UNIVERSAL
# Version: 1.0.0
# Zuletzt validiert: 2026-03-04

SYNC HANDLER
============

BESCHREIBUNG
============
Synchronisiert Dateisystem-Inhalte mit der BACH-Datenbank. Liest Skills und
Tools aus Dateien (Markdown, Text, Python) und aktualisiert/erstellt entsprechende
Datenbankeinträge. Vergleicht Änderungen mittels SHA256-Hashing.

OPERATIONEN
===========
skills              Skills-Inhalte von Dateien in DB laden
tools               Tools-Inhalte von Dateien in DB laden
all                 Beides synchronisieren (Skills + Tools)
status              Sync-Status anzeigen, änderte Dateien hervorheben

OPTIONEN
========
--dry-run           Änderungen nur anzeigen, nicht ausführen
--force             Hash-Vergleich ignorieren, alles neu laden

BEISPIELE
=========
bach --sync skills
    Synchronisiert alle Skills aus skills/ in die Datenbank.
    Findet: .md, .txt, .py Dateien (rekursiv).
    Überspringt: Dateien mit _ oder . am Anfang (ausser .py).

bach --sync tools
    Synchronisiert alle Python-Tools aus tools/ in die Datenbank.
    Findet: *.py Dateien (rekursiv).
    Überspringt: Dateien mit _ oder . am Anfang.

bach --sync all --dry-run
    Zeigt geplante Änderungen ohne sie auszufuehren.

bach --sync status
    Prüft Änderungen: vergleicht Datei-Hashes mit DB-Hashes.
    Meldet: [GEAENDERT], [FEHLT], [NEU], [OK].

bach --sync all --force
    Erzwingt Reload aller Dateien (ignoriert Hash-Vergleich).

DATEIEN
=======
skills/                 Quelle für Skill-Dateien (.md, .txt, .py)
tools/                  Quelle für Tool-Python-Dateien (.py)
data/bach.db            Zieldatenbank
                        Tabellen: skills, tools
                        Spalten: name, path, content_hash, description, ...

SIEHE AUCH
==========
docs/help/              Weitere Handler-Dokumentation
hub/sync.py            Implementierung (Sourcecode)
