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

================================================================================
HANDLER: db
================================================================================

BESCHREIBUNG
  Datenbank-Operationen für die zentrale BACH-Instanz. Verwaltet SQLite-Daten,
  führt Queries aus, exportiert Tabellen und erstellt Backups. Ersetzt Supabase
  MCP als lokale Lösung.

OPERATIONEN
  status             Zeigt Datenbank-Übersicht (Tabellen, Größe, Version)
  tables             Listet alle Tabellen mit Zeilenanzahlen auf
  info <tabelle>     Details: Schema, Spalten, dist_type-Verteilung, Beispiele
  query "SQL"        Führt SQL-Query aus (SELECT oder DML)
  schema <tabelle>   Zeigt CREATE TABLE Statement mit Indices
  count <tabelle>    Zeilenanzahl einer einzelnen Tabelle
  export <tabelle>   Exportiert Tabelle als CSV oder JSON
                     Optionen: --format csv|json (default: csv)
  insert <tabelle>   Fügt Datensatz ein (JSON-Format)
  backup             Erstellt Quick-Backup in data/_backups/

BEISPIELE
  bach db status
    -> Zeigt Datenbank-Status, Tabellenzahl, Größe, Views, Indices

  bach db tables
    -> Listet alle Tabellen mit Zeilenanzahlen auf

  bach db info agents
    -> Zeigt Schema, Spalten, dist_type-Verteilung und 5 Beispielzeilen

  bach db query "SELECT * FROM agents WHERE status='active' LIMIT 10"
    -> Führt Query aus, zeigt max 50 Zeilen

  bach db schema prompts
    -> Zeigt CREATE TABLE und INDEX-Statements

  bach db export runs --format json
    -> Exportiert 'runs' als JSON nach data/export/runs_YYYYMMDD_HHMMSS.json

  bach db insert tasks '{"title":"Test","priority":1}'
    -> Fügt Datensatz in 'tasks' ein (validiert Spalten)

  bach db backup
    -> Erstellt data/_backups/bach_quick_YYYYMMDD_HHMMSS.db

DATEIEN
  data/bach.db                    Zentrale SQLite-Datenbank
  data/export/                    Exportdateien (CSV, JSON)
  data/_backups/                  Quick-Backups

SIEHE AUCH
  base.py                         BaseHandler-Klasse
  data/                           Datenbank-Verzeichnis
  Bach CLI-Hilfe: bach --help
