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

HANDLER-NAME
  lesson

BESCHREIBUNG
  Lessons Learned Management - Dokumentation von Problemen, Lösungen und Best Practices.
  Speichert Lektionen in der SQLite-Datenbank (data/bach.db) mit Kategorie, Severity und
  Zeitstempel. Unterstützt volle Verwaltung: Hinzufügen, Bearbeiten, Deaktivieren und Suche.

OPERATIONEN
  add              Neue Lesson hinzufügen mit Titel und Lösung
  edit             Lesson bearbeiten (Titel, Solution, Category, Severity)
  deactivate       Lesson deaktivieren (mit optionalem Grund)
  list             Alle aktiven Lessons anzeigen (optional gefiltert nach Kategorie)
  last             Letzte n Lessons anzeigen (Standard: 5)
  search           Lessons nach Schlüsselwort durchsuchen
  show             Vollständige Details einer Lesson mit ID
  categories       Verfügbare Kategorien anzeigen

KATEGORIEN
  bug, workflow, tool, integration, performance, general

SEVERITY-LEVEL
  low, medium, high, critical

BEISPIELE
  # Lesson mit Titel und Lösung hinzufügen
  bach lesson add "DB-Pfad: Immer data/bach.db verwenden"

  # Mit Kategorie und Severity
  bach lesson add "Handler-Bug: base_path nicht root" --category bug --severity high

  # Mit Problembeschreibung
  bach lesson add "Titel" --problem "Was ging schief" --category workflow

  # Lesson bearbeiten
  bach lesson edit 5 --title "Neuer Titel" --severity critical

  # Letzte 3 Lessons zeigen
  bach lesson last 3

  # Alle Lessons einer Kategorie anzeigen
  bach lesson list bug

  # Nach Schlüsselwort suchen
  bach lesson search "database"

  # Vollständige Details anzeigen
  bach lesson show 5

  # Lesson deaktivieren
  bach lesson deactivate 5 --reason "Nicht mehr relevant"

  # Verfügbare Kategorien zeigen
  bach lesson categories

DATEIEN
  hub/lesson.py           Handler-Implementierung
  data/bach.db            SQLite-Datenbank (Tabelle: memory_lessons)
  docs/help/lesson.txt    Diese Hilfedatei

SIEHE AUCH
  hub/base.py             BaseHandler-Klasse
  core/hooks.py           Hook-System (after_lesson_add)
