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

PROFILE HANDLER
===============================================================================

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

Der Profile Handler verwaltet das Benutzerprofil in BACH, kombiniert dabei
Daten aus zwei Quellen: eine persistente JSON-Konfiguration (user/profile.json)
und gelernte Präferenzen aus der SQLite-Datenbank (bach.db, Tabelle
assistant_user_profile). Der Handler unterstützt das Anzeigen, Bearbeiten
und Exportieren von Profilinformationen.


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

show
  Kombinierte Profil-Ansicht (JSON + DB)
  Zeigt: Name, Rolle, Sprache, Timezone, OS aus profile.json
  Zeigt: Gelernte Präferenzen aus der Datenbank (nach Kategorien)
  Syntax: profile show

edit <kategorie> <key> <value>
  Profil-Eigenschaft in der Datenbank setzen oder aktualisieren
  Erlaubte Kategorien: praeferenz, gewohnheit, eigenheit
  Speichert mit Konfidenz "hoch" und Quelle "user-input"
  Syntax: profile edit praeferenz sprache deutsch

update <kategorie> <key> <value>
  Alias für edit (identische Funktionalität)
  Syntax: profile update gewohnheit editor vim

stats
  Zeigt Profil-Statistiken
  JSON-Version, aktualisiertes Datum und Anzahl DB-Einträge
  Bricht DB-Einträge nach Kategorien auf
  Syntax: profile stats

json
  Zeigt den Inhalt von user/profile.json als formatiertes JSON
  Syntax: profile json

db
  Zeigt alle gelernte Einträge aus assistant_user_profile
  Enthält Kategorie, Schlüssel, Wert und Konfidenz-Level
  Nach Kategorie und Schlüssel sortiert
  Syntax: profile db

export
  Profil als Gesamt-Übersicht exportieren
  Vereinigte Darstellung aller Profile aus JSON und DB
  Enthält: Basics, Traits, Values, Goals, Preferences, Learned
  Syntax: profile export


BEISPIELE
===============================================================================

Profil anzeigen:
  $ bach profile show

Neue Präferenz hinzufügen:
  $ bach profile edit praeferenz coding_language python

Gewohnheit einlernen:
  $ bach profile edit gewohnheit morgens_up 0700

Statistiken ansehen:
  $ bach profile stats

Komplettes Profil als Text exportieren:
  $ bach profile export

Datenbank-Einträge prüfen:
  $ bach profile db


DATEIEN
===============================================================================

user/profile.json
  Hauptprofil-Datei mit statischen Daten (Name, Rolle, OS, Timezone)
  JSON-Format mit Abschnitten: meta, stats, traits, values, goals, preferences

data/bach.db
  SQLite-Datenbank mit Tabelle assistant_user_profile
  Speichert gelernte Profile pro Kategorie (praeferenz, gewohnheit, eigenheit)
  Jeder Eintrag trägt Konfidenz-Level und Erstellungs-/Änderungszeiten


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

docs/help/base.txt       Handler-Grundlagen
data/bach.db             Profil-Datenbank
user/profile.json        Profil-Konfiguration
