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

BACH UPGRADE - SYSTEM-AKTUALISIERUNG
=====================================

Aktualisiert versionierte BACH-Komponenten selektiv nach Datei oder Kategorie.


VERWENDUNG
----------

  # Upgrade-Status anzeigen
  bach upgrade status

  # Verfügbare Versionen einer Datei anzeigen
  bach upgrade list hub/backup.py

  # Verfügbare Updates prüfen
  bach upgrade check

  # Selektive Kategorie-Upgrades
  bach upgrade core
  bach upgrade templates
  bach upgrade agents
  bach upgrade skills
  bach upgrade hub
  bach upgrade tools
  bach upgrade connectors
  bach upgrade partners
  bach upgrade docs
  bach upgrade gui

  # Dry-Run (nur anzeigen, nicht ausführen)
  bach upgrade agents --dry-run


KATEGORIEN
----------

  core         System-Kern (dist_type=2)
  templates    Vorlagen und Templates (dist_type=1)
  agents       Boss-Agenten und Experten
  skills       Skills und Protokolle
  hub          Hub-Handler
  tools        Tools
  connectors   Connector-System
  partners     Partner-Dateien
  docs         Dokumentation
  gui          GUI-Dateien


WICHTIG
-------

- Upgrade überschreibt nur versionierte Dateien aus Distribution/Manifest.
- USER_DATA bleibt unangetastet.
- Backup wird vor größeren Upgrades empfohlen.
- Versionen werden in `dist_file_versions` getrackt.


BEISPIELE
---------

  # Nur Core-Dateien aktualisieren
  bach upgrade core

  # Nur Templates aktualisieren
  bach upgrade templates

  # Nur Agenten-Dateien als Vorschau prüfen
  bach upgrade agents --dry-run

  # Dokumentation wiederherstellen/upgraden
  bach upgrade docs

  # Verfügbare Versionen einer Datei ansehen
  bach upgrade list hub/backup.py


VERSIONIERUNG
-------------

- Hash + Auto-Increment System (ENT-09)
- Nur versionierte Distribution-Dateien können über `bach upgrade` bewegt werden
- USER_DATA ist vom User und wird nicht versioniert


SIEHE AUCH
----------

  bach --help restore       Template-Wiederherstellung
  bach --help downgrade     Downgrade auf ältere Version
  bach --help seal          Integritätsprüfung
