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

DIRECTORY TRUTH
===============

Automatische Verzeichnis-Zustandsverwaltung.

KONZEPT:
  - Startup: IST-Zustand erfassen, mit SOLL vergleichen
  - Shutdown: Aktueller Zustand wird neuer SOLL
  - Heuristik: Claude-Änderungen sind gewollt

ABLAUF:

1. Erster Start
   - Aktueller Zustand = SOLL-Zustand
   - Gespeichert in data/directory_truth.json

2. Folgende Starts
   - IST-Zustand scannen
   - Vergleich mit SOLL
   - Externe Änderungen anzeigen (User hat was geändert)

3. Shutdown
   - Aktueller Zustand wird neuer SOLL
   - Claudes Änderungen sind jetzt "Standard"

IGNORIERT:
  - __pycache__
  - .pyc Dateien
  - .git, .idea, .vscode
  - auto_log.txt (aendert sich ständig)
  - current.md (Memory)

AUSGABE BEI ÄNDERUNGEN:
  + Neue Ordner/Dateien
  - Gelöschte Ordner/Dateien
  ~ Modifizierte Dateien

VORTEILE:
  - Claude muss nicht manuell tracken was sich geändert hat
  - Externe Änderungen (User) werden erkannt
  - Eigene Änderungen automatisch übernommen

INTEGRATION:
  - Automatisch in hub/startup.py (DirectoryScanner bei Startup)
  - Automatisch in hub/shutdown.py (Zustand bei Shutdown speichern)
  - Kein eigener Handler, Tool-basiert (tools/c_dirscan.py)

CLI (MANUELL):
  python c_dirscan.py                    # Status anzeigen
  python c_dirscan.py --scan             # Aktuellen Zustand scannen
  python c_dirscan.py --compare          # Vergleich IST vs SOLL
  python c_dirscan.py --update           # SOLL-Zustand aktualisieren
  python c_dirscan.py --path /pfad       # Anderes Verzeichnis
  python c_dirscan.py --json             # JSON-Ausgabe

DATEIEN:
  - Tool: system/tools/c_dirscan.py (DirectoryScanner-Klasse)
  - Daten: system/data/directory_truth.json (wird bei erstem Scan erzeugt)
  - Struktur: {timestamp, directories[], files{path: {hash, size}}}
