# Portabilität: UNIVERSAL
# Version: 1.1.0
# Zuletzt validiert: 2026-05-08
# Status: LEGACY — Nachfolger: BACH Chat Service (help bach_chat)

CLAUDE BRIDGE - Telegram <-> Claude Code CLI Integration (LEGACY)
==================================================================

HINWEIS: Claude Bridge wurde durch den BACH Chat Service abgeloest.
         Der neue Service bietet 5 Backends, Control API, Web-Dashboard
         und Cross-Platform System Tray. Siehe: help bach_chat

BESCHREIBUNG
------------
Claude Bridge ist ein Telegram-Bot-Handler, der bidirektionale Kommunikation
zwischen Telegram-Chats und BACH/Claude Code CLI ermöglicht. Der Daemon
laueft im Hintergrund, verarbeitet eingehende Nachrichten, delegiert
längere Aufgaben an Worker-Threads und sendet Ergebnisse via Telegram.

Architektur:
  - Chat-Claude:   Verarbeitet jede Telegram-Nachricht in neuem Context
  - Worker-Claude: Für längere/autonome Tasks (mit Status-Updates)
  - Daemon:        Überwacht Permissions, Budget und Lifecycle
  - Security:      Challenge-Response-System mit konfigurierbarem Passwort


OPERATIONEN
-----------
  bach claude-bridge start              Daemon im Hintergrund starten
  bach claude-bridge stop               Daemon beenden
  bach claude-bridge status             Status: Daemon, Workers, Budget, Modus
  bach claude-bridge mode               Permission-Modus anzeigen (aus config)
  bach claude-bridge test "msg"         Test-Nachricht simulieren (lokal)
  bach claude-bridge logs [N]           Letzte N Log-Zeilen (default: 20)
  bach claude-bridge workers            Letzte 10 Worker mit Status/Fehler
  bach claude-bridge password <pw>      Passwort für Vollzugriff ändern
  bach claude-bridge setup              Interaktiver Setup-Wizard für neue Nutzer
  bach claude-bridge challenge [user]   Security Challenge generieren
  bach claude-bridge verify <ans>       Challenge-Antwort prüfen [--user=ID]


TELEGRAM BEFEHLE (im Chat aktivieren)
-------------------------------------
  toggle                                Vollzugriff ein/aus (1h Auto-Lock)
  mode                                  Aktuellen Modus anzeigen
  budget                                Budget-Status anzeigen
  workers                               Letzte Worker-Übersicht
  stop                                  Laufende Worker sofort beenden


BEISPIELE
---------
  # Daemon starten und 2s warten, dann Status prüfen
  $ bach claude-bridge start
  $ sleep 2
  $ bach claude-bridge status

  # Test-Nachricht lokal simulieren
  $ bach claude-bridge test "Hullo, wie geht's?"

  # Letzte 50 Log-Zeilen anzeigen
  $ bach claude-bridge logs 50

  # Neues Passwort setzen (danach Daemon neu starten)
  $ bach claude-bridge password "MeineNeuesPW123"
  $ bach claude-bridge stop
  $ bach claude-bridge start

  # Security Challenge generieren und verifizierten
  $ bach claude-bridge challenge user_123
  $ bach claude-bridge verify "AntwortText" --user=user_123


DATEIEN
-------
  Handler:   hub/claude_bridge.py
  Daemon:    hub/_services/claude_bridge/bridge_daemon.py
  Config:    hub/_services/claude_bridge/config.json
  Setup:     hub/_services/claude_bridge/setup_wizard.py
  Security:  hub/_services/claude_bridge/security.py
  Logs:      data/logs/claude_bridge.log
  DB:        data/bach.db (Tabelle: claude_bridge_workers)


KONFIGURATION
-------------
Siehe config.json:
  - permissions.default_mode: "restricted" | "interactive" | "full"
  - permissions.password: Passwort für Vollzugriff
  - telegram.token: Bot-Token (via Setup setzen)
  - workers.max_concurrent: Max. gleichzeitige Worker (default: 3)
  - budget.hourly_limit: API-Kosten-Limit pro Stunde


SIEHE AUCH
----------
  help connector               Connector-System (Telegram, etc.)
  help partner                 Partner-System (Multi-LLM)
  hub/_services/claude_bridge/ Handler-Verzeichnis
