# Portabilität: UNIVERSAL
# Version: 1.1.0
# Zuletzt validiert: 2026-05-11

PATH
====

`bach path` macht die zentrale Pfad-Registry aus `hub/bach_paths.py`
direkt über CLI und API nutzbar. Die Ausgabe ist sowohl menschenlesbar
als auch mit `--json` für Automationen geeignet.


BEFEHLE
=======

  bach path
    Zeigt die wichtigsten BACH-Pfade gruppiert an.

  bach path <name>
  bach path get <name>
    Zeigt einen einzelnen registrierten Pfad mit Metadaten an.

  bach path list [--json]
    Listet die vollständige Registry.

  bach path resolve <relativer-pfad> [--from-root] [--json]
    Löst einen relativen Pfad gegen `system/` oder den Repo-Root auf.

  bach path overrides [--json]
    Zeigt aktive DB-Pfad-Overrides aus `system_config`.

  bach path validate [--json]
    Prüft kritische, wichtige und optionale Pfade.

  bach path set <name> <pfad>
    Speichert einen Pfad-Override in der kanonischen BACH-DB.


BEISPIELE
=========

  bach path
    -> Zusammenfassung für Operatoren

  bach path db
    -> Kanonischer Datenbankpfad

  bach path list --json
    -> Vollständige Registry als JSON

  bach path resolve docs/README.md --from-root
    -> Absoluter Pfad relativ zum Repo-Root

  bach path overrides
    -> Aktive DB-Overrides prüfen


JSON-SURFACES
=============

Diese Aufrufe liefern maschinenlesbare Antworten:

  bach path --json
  bach path list --json
  bach path db --json
  bach path overrides --json
  bach path validate --json
  bach path resolve docs/help/path.txt --json


WICHTIGE DETAILS
================

- Quelle bleibt `hub/bach_paths.py` (Single Source of Truth).
- Bei fremdem `base_path` spiegelt der Handler Pfade auf den aktiven
  Runtime-Root, damit Tests und portable Instanzen saubere Ergebnisse
  erhalten.
- Overrides werden aus der kanonischen DB des aktiven Roots gelesen und
  geschrieben, nicht aus einem global hartcodierten Pfad.


DATEIEN
=======

  hub/path.py                CLI-/API-Handler
  hub/bach_paths.py          Zentrale Pfad-Registry
  data/bach.db               `system_config` für Pfad-Overrides


SIEHE AUCH
==========

  help agent                 Agenten-CLI
  help scheduler             Scheduler-Statusflächen
  help tools                 Werkzeug-Übersicht
