# Portabilität: UNIVERSAL
# Version: 1.1.0
# Zuletzt validiert: 2026-05-06

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

Status Handler - Schnelle Systemübersicht des BACH-Systems


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

Der Status Handler bietet einen schnellen Überblick über den aktuellen Zustand
des BACH-Systems. Er zeigt Informationen über aktive Sessions, online Partner,
Memory-Bestaende, ungelesene Nachrichten, offene Tasks, registrierte Tools und
die Systemgesundheit an. Alle Informationen werden direkt aus `data/bach.db`
ermittelt.


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

show
    Zeigt den kompletten Systemstatus an (Standard-Operation).
    Befehl: bach --status [show]
    Rückgabe: Formatierte Text-Ausgabe mit allen Statusmeldungen


BEISPIELE
=========

1. Systemstatus anzeigen (Standardform)
   $ bach --status

2. Status-Abfrage mit expliziter Operation
   $ bach --status show


AUSGABE-FELDER
==============

Session
    - Aktive Session-ID und Partner falls eine Session offen ist
    - Sonst: "Keine aktive Session"

Partner
    - Anzahl aktuell online eingestempelter Partner
    - Vorschau der Partner-Namen

Memory
    - Anzahl Einträge in Working Memory, Facts und Lessons

Chat
    - Anzahl ungelesener Nachrichten aus `messages`

Tasks
    - Anzahl offener Tasks (`status='pending'`)
    - Separat: Anzahl P1/P2-Tasks und blockierte Tasks

Tools
    - Gesamtzahl verfügbarer Tools aus der `tools`-Tabelle

Health
    - OK: Datenbank vorhanden und Kern-Tabellen lesbar
    - FEHLER: `bach.db` fehlt oder Kernabfragen schlagen fehl


DATENQUELLEN (relativ zu system/)
=================================

data/bach.db
    Zentrale Laufzeitdatenbank

Wichtige Tabellen:
    - `memory_sessions`
    - `partner_presence`
    - `memory_working`, `memory_facts`, `memory_lessons`
    - `messages`
    - `tasks`
    - `tools`

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

- hub/startup.py: Startup-Report mit ausführlicherem Session-Kontext
- hub/base.py: BaseHandler-Klasse
- hub/messages.py: Nachrichten-Status und Inbox
- hub/task.py: Task-Zaehler und Task-Details
