BACH MONITORING TOOLS
=====================

Tools zur Systemüberwachung, Konsistenzprüfung und Fehlererkennung.

SCHNELLSTART
------------
  bach --maintain registry     # DB/JSON Konsistenz prüfen
  bach --maintain skills       # Skill-Gesundheit prüfen
  bach --status               # Systemstatus anzeigen

ÜBERSICHT MONITORING-TOOLS
---------------------------
tools/maintenance/
├── registry_watcher.py       # DB-JSON Konsistenzprüfung
└── skill_health_monitor.py   # Skill-Validierung

REGISTRY WATCHER
----------------
Prüft Konsistenz zwischen SQLite-Datenbank und JSON-Konfigurationen.

  python tools/maintenance/registry_watcher.py check
  python tools/maintenance/registry_watcher.py repair

Was wird geprüft:
- Tabellen-Existenz in bach.db
- JSON-Konfig-Dateien Validitaet
- Referentielle Integrität
- Orphaned Records (Waisen-Einträge)

SKILL HEALTH MONITOR
--------------------
Validiert alle BACH-Skills und Agenten.

  python tools/maintenance/skill_health_monitor.py check
  python tools/maintenance/skill_health_monitor.py report

Was wird geprüft:
- SKILL.md Vollständigkeit
- Agent-Manifeste
- Verzeichnisstruktur
- Verwaiste Skills

TOKEN MONITORING
----------------
Überwacht Token-Verbrauch für Kostenkontrolle.

Tabelle: monitor_tokens
- session_id, tokens_used, timestamp
- Token-Zonen (1-4) für Partner-Delegation

  bach --memory status         # Token-Zone anzeigen
  SELECT * FROM monitor_tokens; # Rohdaten

PROCESS MONITORING
------------------
Tabelle: monitor_processes
- Laufende Prozesse
- Wartungs-Daemon-Status
- Background-Jobs

  bach daemon status           # Wartungs-Daemon prüfen
  bach --status               # Gesamtstatus

SUCCESS MONITORING
------------------
Tabelle: monitor_success
- Erfolgsraten von Tools
- Fehlerhistorie
- Lernmuster für Verbesserungen

AUTOMATISCHE CHECKS BEI --startup
---------------------------------
Diese Checks laufen automatisch bei Session-Start:

1. Directory Scan         # Änderungen seit letzter Session
2. Path Healer (dry-run)  # Pfadkorrektur-Vorschläge
3. Registry Watcher       # DB/JSON Konsistenz
4. Skill Health Monitor   # Skills/Agenten Zustand

Probleme werden als Warnings in Startup-Ausgabe gemeldet.

DATENBANK-TABELLEN
------------------
27 Tabellen in bach.db, davon Monitoring-relevant:

  monitor_tokens      # Token-Tracking
  monitor_success     # Erfolgsraten
  monitor_processes   # Prozess-Status

CLI-BEFEHLE
-----------
  bach --maintain heal        # Pfad-Korrektur (dry-run)
  bach --maintain registry    # DB/JSON Konsistenz
  bach --maintain skills      # Skill-Gesundheit
  bach --maintain docs        # Dokumentations-Check
  bach --status              # Gesamtstatus

LOGS UND AUSWERTUNG
-------------------
Monitoring-Daten werden in Logs gespeichert:

  logs/auto_log_extended.txt  # Befehls-Log
  logs/errors/               # Fehler-Logs

Auswertung:
  bach --logs tail 20          # Letzte 20 Log-Einträge
  bach --logs search "error"   # Nach Fehlern suchen

ALARME UND WARNUNGEN
--------------------
- Token-Zone 3/4: Warnung bei hohem Verbrauch
- Skill-Fehler: Warning bei --startup
- DB-Inkonsistenz: Error mit Repair-Vorschlag

TIPPS
-----
- --maintain Befehle regelmäßig ausführen
- Bei Problemen: bach --maintain heal --execute
- Token-Verbrauch im Auge behalten (Zone 2-3)
- Fehler-Logs bei Problemen prüfen

SIEHE AUCH
----------
  bach --help maintain         # Wartungs-Übersicht
  bach --help startup          # Startup-Checks
  bach --help logs             # Log-System
  tools/TOOLS_CONCEPT.md       # Tool-Konzept

---
Version: 1.0.0
Erstellt: 2026-01-23
Teil von: BACH Tool-Dokumentation
