vault list

Zeigt alle Vaults an, die in der Mount-Registry eingetragen sind — typischerweise unter ~/.config/apparat/mounts.yaml — samt Status pro Eintrag. Reine Lese-Operation, kein Write.

Grundaufruf

apparat vault list

Beispiel-Ausgabe:

Mount registry: /home/max/.config/apparat/mounts.yaml

[ok]  recherche
  URL:  https://apparat.example.com/vaults/recherche
  Path: /home/max/vaults/recherche

[missing]  (unnamed)
  URL:  https://apparat.example.com/vaults/alt
  Path: /mnt/external/vaults/alt
  Note: Registered path does not exist.

[mismatched]  arbeit
  URL:  https://apparat.example.com/vaults/arbeit
  Path: /home/max/vaults/arbeit
  Note: Manifest URL "https://other.example.com/vaults/arbeit" does not match the registered URL.

3 registered vault(s).

In farbfähigen Terminals werden die Status-Marker farblich hervorgehoben: [ok] grün, [missing] rot, [mismatched] gelb. Auf Pipes, in Logs und bei --json bleibt die Ausgabe farblos.

Status-Klassifikation

• ok — Pfad existiert, Manifest ist lesbar, und die URL im Manifest stimmt mit der registrierten URL überein.
• missing — Pfad existiert nicht, oder enthält kein lesbares Manifest (.apparat/manifest.json fehlt oder defekt).
• mismatched — Pfad enthält ein Manifest, aber dessen url-Feld passt nicht zur registrierten URL. Kann passieren, wenn ein Vault-Verzeichnis durch ein anderes ersetzt wurde oder das Manifest extern editiert wurde.

Der Exit-Code ist immer 0, wenn die Registry lesbar war — der Status ist ein Beobachtungs­wert, kein Fehler. Ist die Registry selbst defekt (kaputtes YAML, falsche Struktur), bricht das Kommando mit 1 ab.

JSON-Ausgabe

Für Scripting:

apparat vault list --json

Gibt ein JSON-Objekt auf stdout aus:

{
  "registry": "/home/max/.config/apparat/mounts.yaml",
  "count": 3,
  "mounts": [
    {
      "url": "https://apparat.example.com/vaults/recherche",
      "path": "/home/max/vaults/recherche",
      "name": "recherche",
      "status": "ok",
      "message": null
    },
    {
      "url": "https://apparat.example.com/vaults/alt",
      "path": "/mnt/external/vaults/alt",
      "name": null,
      "status": "missing",
      "message": "Registered path does not exist."
    }
  ]
}

Verwandte Kommandos

• vault init — neuen Vault anlegen und automatisch in der Registry registrieren.
• vault register — bestehenden Vault (z.B. aus git clone kommend) in die Registry aufnehmen, ohne das Manifest neu zu schreiben.
• vault unregister — Eintrag aus der Registry entfernen, ohne die Dateien anzutasten.