[Feature]: Host-Disk-Speicherplatz in get_host_info durchreichen (wartet auf Upstream #976)

[strausmann]

Beschreibung

Sobald Dockhand den freien Speicherplatz des Host-Dateisystems über die API bereitstellt (siehe Upstream-Feature-Request Finsys/dockhand#976), sollen die entsprechenden Felder in get_host_info durchgereicht werden.

Aktuell liefert /api/host laut Dockhand-Quellcode (src/routes/api/host/+server.ts) nur hostname, ipAddress, platform, arch, cpus, totalMemory, freeMemory, uptime, dockerVersion, dockerContainers, dockerContainersRunning, dockerImages — kein Feld für Disk-Kapazität. Der bestehende Endpunkt /api/system/disk (genutzt über getDiskUsage) liefert Dockers eigene Speichernutzung (Images/Container/Volumes/Build-Cache), nicht die Kapazität des zugrunde liegenden Host-Dateisystems.

Motivation

Ohne freien Host-Speicherplatz lässt sich über Dockhand/MCP nicht prüfen, ob auf einem Knoten noch Platz für neue Stacks ist — man muss auf SSH + df -h ausweichen. Das widerspricht dem Zweck des MCP-Servers als zentrale Docker-Verwaltungsschnittstelle.

Möglicher Implementierungsweg

1. Upstream-Fortschritt bei [Feature Request] Disk space of the host Finsys/dockhand#976 beobachten.
2. Sobald /api/host (oder ein neuer Endpunkt) Felder wie diskTotal/diskFree/diskAvailable liefert: Typen in get_host_info ergänzen und die neuen Felder durchreichen.
3. Bei Hawser-Agent-Umgebungen prüfen, ob der Wert vom Agent-Knoten stammt (nicht vom Dockhand-Host selbst) — relevant, weil /var/lib/docker auf einem anderen Datenträger liegen kann als das Root-Dateisystem.

Betroffene MCP-Tools

• get_host_info

Betroffene Komponente

Other (Host-/System-Info)

Referenzen

• Upstream-Feature-Request: [Feature Request] Disk space of the host Finsys/dockhand#976

[strausmann]

Upstream status check (2026-08-10): Finsys/dockhand#976 ("Disk space of the host") is still OPEN — the host disk-space field is not yet exposed by the Dockhand API. This issue stays blocked/open, tracking upstream. Will revisit when #976 ships.

[strausmann]

Statuscheck (2026-08-10): Upstream Finsys/dockhand#976 (Host-Disk-Space über die API) ist weiterhin OPEN — /api/host liefert nach wie vor kein Disk-Kapazitätsfeld. Damit bleibt dieses Issue blockiert; get_host_info kann die Felder erst durchreichen, sobald der Upstream-Endpunkt sie bereitstellt. Bleibt offen, Wiedervorlage bei Upstream-Fortschritt.

[strausmann]

Upstream-PR für den Blocker ist offen: Finsys/dockhand#1397 ergänzt diskTotal/diskFree/diskAvailable (Bytes) in /api/host via fs.statfs('/') und schließt Finsys/dockhand#976.

Sobald der PR gemergt ist, ist dieses Issue ein kleiner Passthrough in get_host_info: die drei optionalen Felder in Typ + Response durchreichen. Bleibt bis zum Upstream-Merge blockiert — jetzt aber mit aktivem PR statt reinem Warten.