# Portabilität: UNIVERSAL
# Version: 1.0.0
# Zuletzt validiert: 2026-05-17
# Nächste Prüfung: 2026-08-17

HANDLER-NAME
============
integration

BESCHREIBUNG
============
LLM-Partner-Integration und BACH-Kontext-Synchronisation. Verwaltet die Verbindung zu
externen KI-Systemen (Claude, Gemini, Ollama) über strukturierte Markdown-Datei-Blöcke
mit eindeutigen Markern. Basis: Stufe-2-Managed (CLAUDE.md/GEMINI.md/OLLAMA.md Push).

Teil von SQ038: Claude Code Integration & LLM-Partner-Brücke.

OPERATIONEN
===========
status            Zeige aktuellen Integration-Status (Default)
                  Quellen: system_config, CLAUDE.md Marker-Check
                  Ausgabe: Konfiguration, Dateistatus, Stufen-Modell

push-claude       Push BACH-Block zu CLAUDE.md (Stufe 2 Managed)
                  Erfordert: tools/claude_md_sync.py + Parent-Verzeichnis
                  Effekt: Erstellt oder aktualisiert BACH:START...BACH:END

push-gemini       Push BACH-Block zu GEMINI.md (Stufe 2 Managed)
                  Identisch wie push-claude, Partner: GEMINI

push-ollama       Push BACH-Block zu OLLAMA.md (Stufe 2 Managed)
                  Identisch wie push-claude, Partner: OLLAMA

pull-claude       [NOCH NICHT IMPLEMENTIERT - Stufe 3]
                  Geplant: Manueller Content aus CLAUDE.md zurück zu DB

config            Zeige aktuelle Integration-Konfiguration aus system_config
                  Filter: Alle Keys mit Prefix 'integration.*'
                  Anzeige: Key, Wert, optional Beschreibung

set <partner>     Setze Integration-Level pro Partner
<level>           Partner: claude, gemini, ollama, claude-code, ...
                  Level: off | sync | managed | full
                  Speicherort: system_config (DB)
                  off     = Kein BACH-Eingriff
                  sync    = MEMORY.md aus DB (SQ065)
                  managed = CLAUDE.md BACH-Block (aktuell verfügbar)
                  full    = Hooks + Kontext-Injektion (geplant)

BEISPIELE
=========
1. Integration-Status prüfen:
   bach integration status

2. BACH-Block in CLAUDE.md aktualisieren:
   bach integration push-claude

3. Claude-Integration auf Stufe 2 aktivieren:
   bach integration set claude-code managed

4. Aktuelle Konfiguration anzeigen:
   bach integration config

5. Integration deaktivieren:
   bach integration set claude-code off

DATEIEN
=======
hub/integration.py          Handler-Implementierung (IntegrationHandler-Klasse)
tools/claude_md_sync.py     ClaudeMdSync - Synchronisation und BACH-Block-Verwaltung
data/bach.db                system_config Tabelle: Integration-Level pro Partner
                            Key-Format: integration.<partner>.level

SIEHE AUCH
==========
- hub/base.py               BaseHandler-Klasse (Vererbung)
- docs/HANDLER.md           Handler-Architektur
- BACH_Dev/BACH_Memory_Architektur_Konzept.md  SQ038-Spezifikation
