# Portabilität: SYSTEM
# Zuletzt validiert: 2026-05-17
# Nächste Prüfung: 2026-08-17
# Ressourcen: [instance_identity table], [hub/dist.py], [tools/generators/distribution_system.py]

IDENTITY-SYSTEM
===============

Stand: 2026-05-17

Das Identity-System gewährleistet die Integrität und Identifikation der BACH-Instanz.
Funktionen sind im Distribution-Handler implementiert und über CLI erreichbar.

TABELLE: system_identity (Zentrales Singleton)
----------------------------------------------
  - id:               Primary Key (MUSS 1 sein - Singleton)
  - instance_id:      Eindeutige UUID der Installation
  - instance_name:    Individueller Name (z.B. "BACH_Alpha")
  - version:          Aktuelle BACH-Version (z.B. v1.1.83)
  - created_at:       Erstellungsdatum
  - seal_status:      Integritäts-Status ('intact' | 'broken')
  - kernel_hash:      SHA256 der System-Kern-Dateien
  - last_verified:    Letzter Verifizierungs-Zeitpunkt
  - current_mode:     Betriebsmodus (default: 'developer')
  - last_boot:        Letzter Boot-Zeitpunkt
  - boot_count:       Anzahl Boots (default: 0)

SIEGEL-MECHANISMUS
------------------
  1. Boot-Check: Bei jedem Startup wird der Kernel-Hash berechnet
  2. Vergleich: Stimmt der Hash mit der DB überein?
  3. Status: Bei Abweichung wird das Siegel "gebrochen" (broken)
  4. Warnung: Ein gebrochenes Siegel weist auf manuelle Eingriffe hin

CLI-BEFEHLE
-----------
  bach --dist status         System-Status mit Siegel-Info anzeigen
  bach --dist verify         Siegel-Integrität prüfen
  bach --dist classify       dist_type Verteilung anzeigen
  bach --dist snapshot NAME  Snapshot erstellen
  bach --dist release NAME   Release erstellen
  bach --dist list           Snapshots/Releases auflisten

NICHT IMPLEMENTIERT
-------------------
  bach --dist reseal         (EXISTIERT NICHT - keine Reseal-Funktion)

Bei gebrochenem Siegel gibt es keinen automatischen Repair. Man muss manuell
via distribution_system.py ein neues Siegel setzen.

IMPLEMENTATION
--------------
  Handler:        system/hub/dist.py (DistHandler)
  Backend:        system/tools/generators/distribution_system.py
  Operations:     status, verify, classify, snapshot, release, restore, install, list

KONTEXT
-------
Identity ist Teil des Distribution-Systems (ehemals Governance-Schicht 5).
Sie stellt sicher dass das "Gedaechtnis" (DB) zur "Hardware" (Dateisystem) passt.

SIEHE AUCH
----------
  docs/help/maintain.txt        Wartungs-Tools (keine Identity-Funktion)
  docs/help/distribution.txt    Distribution & Releases
  docs/help/bach_info.txt       System-Übersicht
