# Portabilität: UNIVERSAL
# Version: 1.1.0
# Zuletzt validiert: 2026-02-08
# Nächste Prüfung: 2026-08-08

MAINTAIN - BACH Wartungs-Tools
==============================

ÜBERSICHT
----------
Sammlung von Wartungs- und Analyse-Tools für BACH.
Alle Tools sind CLI-zugaenglich via bach --maintain

BEFEHLE (16)
------------
  bach --maintain docs          Dokumentations-Update-Check
  bach --maintain duplicates    Duplikat-Erkennung Info
  bach --maintain generate      Skill/Agent Generator
  bach --maintain export        Export-Tools
  bach --maintain pattern       Dateinamen-Pattern kuerzen
  bach --maintain scan          System nach CLI-Tools scannen
  bach --maintain clean         Dateien nach Alter/Muster löschen
  bach --maintain json          JSON-Dateien reparieren
  bach --maintain heal          Pfad-Korrektur und Selbstheilung
  bach --maintain registry      Registry-Konsistenz prüfen
  bach --maintain skills        Skill-Gesundheit prüfen
  bach --maintain sync          Skills mit Datenbank synchronisieren
  bach --maintain headers       SKILL.md YAML-Header generieren/validieren
  bach --maintain skill-help    Help-Dateien aus SKILL.md generieren
  bach --maintain workflows     Workflow-Format validieren
  bach --maintain nul           Windows NUL-Dateien entfernen
  bach --maintain list          Alle Tools anzeigen

DOKUMENTATIONS-CHECK
--------------------
  bach --maintain docs [--dry-run]
  
  Erkennt veraltete Dokumentationen:
  - Älter als 60 Tage
  - Ungueltige Pfade
  - Fehlende Referenzen

SKILL GENERATOR
---------------
  bach --maintain generate <n> [profil] [zielordner]

  Profile:
    MICRO    - Nur Datei(en)
    LIGHT    - Minimal (SKILL.md + config + data)
    STANDARD - Standard mit Memory
    EXTENDED - Komplex mit Mikro-Skills

  Beispiele:
    bach --maintain generate mein-skill STANDARD skills/
    bach --maintain generate analyse MICRO skills/workflows/

EXPORT TOOLS
------------
  bach --maintain export skill <n> --from-os <path>
  bach --maintain export agent <n> --from-os <path>
  bach --maintain export os-fresh <path> --output <zip>
  bach --maintain export os-reset <path> --backup

PATTERN TOOL
------------
  bach --maintain pattern <ordner> [optionen]
  
  Optionen:
    --dry-run       Nur anzeigen (default)
    --execute       Umbenennungen durchführen
    --prefix-only   Nur Prefix-Patterns
    --suffix-only   Nur Suffix-Patterns
    -m <n>          Minimale Pattern-Laenge

TOOL SCANNER
------------
  bach --maintain scan [--json]
  bach --maintain scan compare
  
  Findet installierte CLI-Tools und vergleicht mit Registry.

FILE CLEANER
------------
  bach --maintain clean <ordner> [optionen]
  
  Optionen:
    --age <tage>    Dateien älter als X Tage
    --keep <n>      Nur N neueste behalten
    --pattern <p>   Datei-Pattern (z.B. "*.log")
    -r              Rekursiv suchen
    --execute       Tatsaechlich löschen

  Beispiele:
    bach --maintain clean ./logs --age 30
    bach --maintain clean ./backups --keep 5 --execute

JSON FIXER
----------
  bach --maintain json <datei/ordner> [optionen]
  
  Optionen:
    --dry-run    Nur prüfen (default)
    --execute    Tatsaechlich reparieren
    --backup     Backup vor Änderung

  Repariert:
    - UTF-8 BOM
    - Trailing Commas
    - Single-Quotes
    - PowerShell Newlines

PATH HEALER (NEU)
-----------------
  bach --maintain heal [optionen]
  
  Korrigiert veraltete Pfade in BACH-Dateien.
  
  Optionen:
    --dry-run       Nur prüfen, nichts ändern (default)
    --execute       Tatsaechlich korrigieren
    --target <p>    Nur bestimmte Datei prüfen
    --report        Detaillierten Report generieren
    
  Korrigiert:
    - Alte recludOS-Pfade -> BACH
    - Alte Skill-Pfade
    - Hub/Handler-Pfade
    - Tools-Verweise
    
  Beispiele:
    bach --maintain heal                   # Dry-run für alle
    bach --maintain heal --execute         # Alle korrigieren
    bach --maintain heal --target config.py

  Basiert auf: RecludOS Unified Path Healer v2.3.0

REGISTRY WATCHER (NEU)
----------------------
  bach --maintain registry [optionen]
  
  Überwacht und validiert alle BACH-Registries.
  
  Optionen:
    check           Vollständiger Check (default)
    check --db      Nur Datenbank prüfen
    check --json    Nur JSON-Configs prüfen
    partners        Partner-Registry Check (NEU)
    report          Detaillierter Report
    
  Prüft:
    - Existenz der Registry-relevanten DB-Tabellen (tools, skills, agents, partners)
    - JSON-Konfigurationsdateien (nur noch begründete Ausnahmen)
    - Cross-Referenzen zwischen Tabellen
    - partner_recognition + delegation_rules Konsistenz

  Hinweis: partner_registry.json ist DEPRECATED (siehe docs/help/formats.txt)
    
  Beispiele:
    bach --maintain registry               # Quick-Check
    bach --maintain registry report        # Detaillierter Report
    bach --maintain registry check --db    # Nur Datenbank
    
  Hinweis: Läuft automatisch bei --startup (Quick-Check)

SKILL HEALTH MONITOR (NEU)
--------------------------
  bach --maintain skills [optionen]
  
  Überwacht und validiert alle BACH-Skills und Agenten.
  
  Optionen:
    check            Vollständiger Check (default)
    check --skills   Nur Skills prüfen
    check --agents   Nur Agenten prüfen
    report           Detaillierter Report
    
  Prüft:
    - Skill-Verzeichnisse (_agents, _experts, _services)
    - SKILL.md Vollständigkeit (name, version, description)
    - Agent-Definitionen validieren
    - Verwaiste oder fehlerhafte Skills finden
    
  Beispiele:
    bach --maintain skills                 # Quick-Check
    bach --maintain skills report          # Detaillierter Report
    bach --maintain skills check --agents  # Nur Agenten
    
  Hinweis: Läuft automatisch bei --startup (Quick-Check)

SYNC TOOL (NEU)
---------------
  bach --maintain sync [optionen]

  Synchronisiert skills/ Dateien mit der Datenbank.

  Optionen:
    --dry-run    Nur anzeigen, nichts ändern (default)
    --verbose    Ausführliche Ausgabe
    -v           Kurz für --verbose

  Synchronisiert:
    - SKILL.md Metadaten (Name, Version, Beschreibung)
    - Skill-Status und Abhängigkeiten
    - Agent-Definitionen

  Beispiele:
    bach --maintain sync               # Dry-run
    bach --maintain sync --verbose     # Mit Details
    bach --maintain sync --dry-run -v  # Dry-run ausführlich

HEADERS TOOL (NEU)
------------------
  bach --maintain headers [optionen]

  Generiert und validiert YAML-Header für SKILL.md Dateien.

  Optionen:
    --all           Alle Skill-Verzeichnisse scannen (default)
    --path <p>      Bestimmtes Verzeichnis scannen
    --file <f>      Einzelne SKILL.md verarbeiten
    --dry-run       Nur anzeigen (default)
    --fix           Änderungen schreiben
    --update-db     DB-Versionen aus YAML-Headern aktualisieren
    -v              Ausführlich

  Gescannte Verzeichnisse:
    - agents/*/SKILL.md
    - agents/_experts/*/SKILL.md
    - hub/_services/*/SKILL.md
    - partners/*/SKILL.md

  Beispiele:
    bach --maintain headers                      # Trockenlauf
    bach --maintain headers --fix                # Alle Header normalisieren
    bach --maintain headers --fix --update-db    # Header + DB aktualisieren
    bach --maintain headers --path agents -v

SKILL-HELP TOOL (NEU)
---------------------
  bach --maintain skill-help [optionen]

  Generiert docs/help/*.txt Dateien aus SKILL.md.

  Optionen:
    <name>       Einzelner Skill-Name
    --all        Alle Skills verarbeiten
    -a           Kurz für --all
    --dry-run    Nur anzeigen, nichts schreiben
    -n           Kurz für --dry-run

  Beispiele:
    bach --maintain skill-help ati              # Help für ATI-Agent
    bach --maintain skill-help --all            # Alle Skills
    bach --maintain skill-help --all --dry-run  # Trockenlauf

WORKFLOWS TOOL (NEU)
--------------------
  bach --maintain workflows [optionen]

  Validiert Workflow-Dateien auf konsistentes Format.

  Prüft:
    - H1-Titel vorhanden
    - Beschreibung (> Blockquote, **Zweck:**, ## Übersicht)
    - Schritte/Phasen-Struktur
    - Versions-Angabe (optional)

  Erwartet in: skills/workflows/*.md

  Beispiele:
    bach --maintain workflows        # Alle Workflows validieren
    bach --maintain workflows help   # Hilfe anzeigen

NUL-CLEANER (NEU)
-----------------
  bach --maintain nul [optionen]

  Entfernt Windows NUL-Dateien (reservierter Dateiname).

  Optionen:
    scan            Nur NUL-Dateien auflisten (default)
    delete          NUL-Dateien löschen
    clean/remove    Alias für delete
    <pfad>          Bestimmtes Verzeichnis scannen

  Beispiele:
    bach --maintain nul                        # Scan BACH-Verzeichnis
    bach --maintain nul scan                   # Nur scannen
    bach --maintain nul delete                 # Scannen und löschen
    bach --maintain nul delete C:\Pfad         # Bestimmtes Verzeichnis

  Hinweis: NUL-Dateien entstehen auf Windows, wenn versehentlich
           nach 'NUL' geschrieben wird (Windows Device-Name).

TOOLS
-----
  tools/doc_update_checker.py        Dokumentations-Prüfung
  tools/duplicate_detector.py        Duplikat-Erkennung
  tools/generators/                  Generator-Scripts
    skill_generator.py               Skill-Strukturen
    exporter.py                      Export-Funktionen
  tools/pattern_tool.py              Pattern-Erkennung
  tools/tool_scanner.py              CLI-Tool Discovery
  tools/file_cleaner.py              Datei-Cleanup
  tools/json_fixer.py                JSON-Reparatur
  tools/c_path_healer.py             Pfad-Korrektur (WICHTIG: c_path_healer!)
  tools/nulcleaner.py                NUL-Dateien entfernen
  tools/skill_header_gen.py          YAML-Header Generator
  tools/skill_help_gen.py            Help-Generator + Workflow-Validator
  tools/maintenance/
    registry_watcher.py              Registry-Konsistenz
    skill_health_monitor.py          Skill-Gesundheit
    sync_skills.py                   Skills-DB Synchronisierung

AUTOMATISCHE CHECKS BEI --startup
---------------------------------
Die folgenden Wartungs-Checks laufen automatisch bei Session-Start:

  1. Directory Scan     - Änderungen seit letzter Session
  2. Path Healer        - Dry-run Pfadkorrektur
  3. Registry Watcher   - Quick-Check DB/JSON Konsistenz
  4. Skill Health       - Quick-Check Skills/Agenten

Für detaillierte Reports: bach --maintain <tool> report

AKTUELLE TOOL-UBERSICHT (16 Befehle)
-------------------------------------
1.  docs          - Dokumentations-Update-Check
2.  duplicates    - Duplikat-Erkennung Info
3.  generate      - Skill/Agent Generator
4.  export        - Export-Tools
5.  pattern       - Dateinamen-Pattern kuerzen
6.  scan          - System nach CLI-Tools scannen
7.  clean         - Dateien nach Alter/Muster löschen
8.  json          - JSON-Dateien reparieren
9.  heal          - Pfad-Korrektur und Selbstheilung
10. registry      - Registry-Konsistenz prüfen
11. skills        - Skill-Gesundheit prüfen
12. sync          - Skills mit Datenbank synchronisieren
13. headers       - SKILL.md YAML-Header generieren/validieren
14. skill-help    - Help-Dateien aus SKILL.md generieren
15. workflows     - Workflow-Format validieren
16. nul           - Windows NUL-Dateien entfernen

SIEHE AUCH
----------
  docs/help/backup.txt   Backup-System
  docs/help/test.txt     Test-System
  docs/help/tools.txt    Tool-Inventar
  docs/help/formats.txt  Datenbank-Formate
