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

HANDLER-NAME
============
obsidian - Obsidian Vault Synchronisation

BESCHREIBUNG
============
Der Obsidian Handler synchronisiert eine lokale Obsidian Vault mit BACH-Daten.
Er verwaltet drei Sync-Kategorien: Daily Notes (tagesaktuelle Notizen), Tasks
(Aufgabenverwaltung) und Wiki (Wissensbasis). Alle Daten stammen aus der
bach.db (Tabellen: tasks, memory_working, wiki_articles).

OPERATIONEN
===========
status
  Zeigt den Sync-Status an (Vault-Pfad, Verzeichnisstruktur, Existenz von
  Daily Notes, BACH Wiki, Tasks-Datei). Keine Argumente erforderlich.

sync
  Führt alle Syncs durch: Daily Note des heutigen Tages, aktuelle Tasks,
  Wiki-Artikel. Keine Argumente erforderlich.

config [path]
  Setzt oder zeigt den Obsidian Vault-Pfad an. Mit Argument <path> wird der
  Pfad konfiguriert und in memory_facts (category='system', key=
  'obsidian_vault_path') gespeichert. Ohne Argument zeigt den aktuellen Pfad.

daily
  Erstellt oder zeigt die Daily Note des heutigen Tages (YYYY-MM-DD.md im
  Verzeichnis "Daily Notes"). Enthält Offene-Tasks-Zaehler und letzte 3
  Arbeitsnotizen aus memory_working.

tasks
  Synchronisiert aktive Tasks (pending, in_progress) aus der Tabelle tasks
  in die Datei "BACH Tasks.md". Sortierung nach Priorität (P1-P3) und ID.

wiki
  Exportiert alle Artikel aus wiki_articles in das Verzeichnis "BACH Wiki".
  Dateinamen werden bereinigt (nur alphanumerisch, Leerzeichen, Bindestrich,
  Unterstrich); der Titel wird aus dem title-Feld oder dem Dateiname abgeleitet.

BEISPIELE
=========
Vault konfigurieren:
  bach obsidian config /path/to/My\ Vault

Status prüfen:
  bach obsidian status

Alle Sync-Kategorien durchführen:
  bach obsidian sync

Nur heutige Daily Note erstellen:
  bach obsidian daily

Tasks aktualisieren:
  bach obsidian tasks

Wiki exportieren:
  bach obsidian wiki

DATEIEN
=======
hub/obsidian.py                    Handler-Implementierung
data/bach.db                       Datenbank (Tabellen: tasks, memory_working,
                                   wiki_articles, memory_facts)

Obsidian Vault (bei Konfiguration):
  {vault}/Daily Notes/             Verzeichnis für Daily Notes
  {vault}/BACH Wiki/               Verzeichnis für Wiki-Artikel
  {vault}/BACH Tasks.md            Tasks-Synchronisierungsdatei

SIEHE AUCH
==========
base.py                            BaseHandler-Klasse
BACH Dokumentation                 bach.db Schema, memory_facts Struktur
