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

COOKBOOK - Rezeptbuch-Tool für DB-Doku-Generierung
====================================================

BESCHREIBUNG
------------
Der Cookbook Handler generiert Doku-Rohfassungen aus Datenbank-Tabellen
mittels vordefinierter Rezepte. Jedes Rezept beschreibt eine SQL-Abfrage,
ein Ausgabe-Template und den Output-Pfad. Nutzt die Tabelle 'cookbook_recipes'
in bach.db zur persistenten Verwaltung.

Unterstützte Templates:
  - markdown_table: Markdown-Tabelle mit Spalten-Struktur
  - markdown_list: Strukturierte Markdown-Liste mit Hierarchie
  - json_export: JSON-Export mit Metadaten

OPERATIONEN
-----------
  bach cookbook list                    Alle Rezepte anzeigen (Name, Titel, Typ)

  bach cookbook generate <rezept>       Rohfassung aus Rezept generieren
                                        Liest Rezept-Definition, führt SQL aus,
                                        wendet Template an, schreibt Output

  bach cookbook delete <name>           Rezept löschen (mit Warnung für CORE)
                                        Flags: --force (erzwingt Löschung)

  bach cookbook help                    Diese Hilfe anzeigen

BEISPIELE
---------
  1. Alle verfügbaren Rezepte auflisten:
     bach cookbook list

  2. Rohfassung aus vorhandenem Rezept generieren:
     bach cookbook generate tools_overview

  3. Rezept löschen (Bestaetigung bei CORE-Rezepten):
     bach cookbook delete my_recipe
     bach cookbook delete core_recipe --force

AUSGABE
-------
  Output-Verzeichnis: data/generated/

  Dateiname wird aus Rezept bestimmt:
  - Output-Feld in recipe_json falls vorhanden
  - Fallback: <rezept-name>.md

  Generierte Dateien enthalten Auto-Generierungsmarker mit Zeitstempel.

DATEIEN
-------
  Handler: hub/cookbook.py
  Datenbank: data/bach.db (Tabelle: cookbook_recipes)
  Output: data/generated/*.md

TABELLEN-SCHEMA
---------------
  cookbook_recipes:
    - name (TEXT): Eindeutiger Rezept-Identifikator
    - title (TEXT): Titel für Doku
    - description (TEXT): Optionale Beschreibung
    - recipe_json (TEXT): JSON-Definition (sql_query, template_type, output_file)
    - dist_type (INT): 0=USER, 1=TEMPLATE, 2=CORE
    - created_at (TIMESTAMP): Erstellungszeit

SIEHE AUCH
----------
  BACH_Dev/docs/SQ069_REZEPTBUCH_KONZEPT.md    Rezeptbuch-Konzept (SQ069)
  hub/base.py                                   BaseHandler-Klasse
