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

HANDLER-NAME
============
Unified Search Handler für BACH (SQ064 + SQ047)


BESCHREIBUNG
============
Volltext-Suche (FTS5) über alle BACH-Quellen: Wiki-Artikel, Memory (Working/
Fakten/Lessons), Dokumentationen, KnowledgeDigest Skills/Wiki und beliebige
gescannte Verzeichnisse. Unterstützt erweiterte Filter nach Quelle, Tags und
Limit. Automatische Indexierung mit Duplikat-Erkennung via Hash-Vergleich.


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

SUCHE (Default)
  <query>                       Volltext-Suche über alle Quellen
  <query> --source SOURCE       Nur in Quelle suchen (wiki|document|memory_*)
  <query> --tag TAG             Filter nach Tag (mehrfach kombinierbar)
  <query> --limit N             Max. Treffer (Default: 20)

INDEXIERUNG
  index                         Alle BACH-Quellen indexieren
  index knowledgedigest|kd      KnowledgeDigest + Wiki indexieren
  index wiki|memory|documents   Einzelne Quelle indexieren
  index <pfad>                  Verzeichnis scannen (ProFiler-Stil)
  index <pfad> --no-tags        Ohne automatische Tag-Ableitung

VERWALTUNG
  status                        Index-Statistiken und Quelle-Übersicht
  rebuild                       Index leeren und komplett neu aufbauen
  tags                          Alle verfügbaren Tags auflisten
  tags TAG1 TAG2                Einträge mit diesen Tags finden
  tags --limit N                Top-N Tags nach Haeufigkeit
  dupes                         Duplikate finden (gleiches Hash, Pfade)
  help                          Diese Hilfe anzeigen


BEISPIELE
=========

Basis-Suche:
  bach search python
  bach search "machine learning"

Mit Quelle:
  bach search encoding --source memory_lesson
  bach search entwickler --source knowledgedigest_skill

Mit Tags und Limit:
  bach search database --tag production --limit 50
  bach search bridge --tag connector --tag network

Indexierung:
  bach search index                    # Alle Quellen
  bach search index knowledgedigest    # Nur KD
  bach search index /c/Users/User/Docs # Verzeichnis
  bach search index .                  # Aktuelles Verzeichnis

Verwaltung:
  bach search status                   # Statistiken
  bach search rebuild                  # Vollreindex
  bach search tags                     # Alle Tags
  bach search tags health system       # Nach Tags suchen
  bach search dupes                    # Duplikate


DATEIEN
=======

hub/search.py                 SearchHandler Implementation
tools/unified_search.py       UnifiedSearch Engine (FTS5)
data/bach.db                  Index-Datenbank (SQLite, FTS5)
docs/help/search.txt          Diese Datei


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

docs/help/index.txt           BACH Command-Line Interface
docs/OPERATIONS.md            Alle Handler und Operationen
tools/unified_search.py       Engine-Doku (Index-Format, FTS5-Syntax)
