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

REFLECTION HANDLER
==================

BESCHREIBUNG
============

Der Reflection Handler analysiert die Selbstreflexion und Performance des BACH-Systems.
Er wertet Informationen aus den Memory-Tabellen aus (working, sessions, lessons, facts)
und zeigt detaillierte Performance-Berichte, Trend-Analysen und identifizierte
Schwachstellen.


OPERATIONEN
===========

status
  Performance-Bericht anzeigen. Liefert aktuellen überblick über System-Metriken
  und allgemeine Performance-Indikatoren.

review [days]
  Performance der letzten N Tage analysieren (Standard: 7 Tage).
  Beispiel: review 14 zeigt die letzten zwei Wochen.

gaps
  Schwachstellen und Luecken identifizieren. Analysiert Memory-Inhalte und zeigt
  Bereiche mit niedriger Abdeckung oder Performance-Problemen.

log
  Reflection-Metriken aus der Datenbank anzeigen. Zeigt die letzten 20 Einträge
  vom Typ 'REFLECTION:*' aus der memory_working Tabelle.


BEISPIELE
=========

  bach reflection status
    -> Zeigt aktuellen Performance-Report mit allen Metriken

  bach reflection review 30
    -> Analysiert Performance der letzten 30 Tage mit detaillierten Trends

  bach reflection gaps
    -> Listet alle identifizierten Schwachstellen auf

  bach reflection log
    -> Zeigt die letzten 20 Reflection-Metriken-Einträge


DATEIEN
=======

hub/reflection.py
  Handler-Implementation mit Operation-Definitionen und Datenbank-Abfragen.

agents/reflection/reflection_analyzer.py
  SelfReflection-Klasse für Analyse-Logik und Report-Generierung.

data/bach.db
  Zentrale SQLite-Datenbank mit Memory-Tabellen:
  - memory_working: Aktuelle Working-Memory (Typ 'note' mit REFLECTION:*)
  - memory_sessions: Session-Historie
  - memory_lessons: Gelernte Lektionen
  - memory_facts: Gespeicherte Fakten


SIEHE AUCH
==========

docs/help/memory.txt
  Dokumentation des Memory-Systems und Tabellen-Struktur.

docs/help/tasks.txt
  Task-Management zur Ergänzung von Performance-Analysen.

agents/reflection/
  Weitere Analyse-Module und Metrik-Definitionen.
