Show container image-update status from Dockhand

Dockhand already tracks per-container image updates internally (its
UI shows this) via a cached check plus an on-demand recheck -- surface
that here instead of only showing running/stopped state.

adapter.listContainers() now also reads GET /api/containers/pending-
updates per environment (a cached read, no registry hit) and merges
each container's hasImageUpdate/newerVersion/checkedAt onto it.
updateAvailable is a tri-state: true (update pending), false (checked,
up to date), or null (never checked) -- distinguishing "no update"
from "we don't know yet" matters since a container can sit unchecked
indefinitely until someone triggers a check.

New adapter.checkForUpdates() triggers a fresh check across every
environment (POST /api/containers/check-updates, one registry lookup
per container so this can take a while) and new POST /:id/dockhand/
check-updates route (operator+, matching the existing container
action's role gating).

Docker page: new "Update" column (badge + tooltip with the newer
version), an "updates available" count next to the running/total
count, and a "Check for updates" button. Dashboard's Dockhand widget
also gained an "Updates" mini-stat, swapped in for the less useful
"Not running" figure (already inferable from running/total).

Field names (hasImageUpdate, newerVersion, checkedAt, the check-
updates response shape) came from Dockhand's own published OpenAPI
spec, not guessed -- and verified against a local mock Dockhand server
covering all three update states (pending, up to date, never checked)
plus the check-updates aggregation across environments, since this
sandbox can't reach the user's real Dockhand instance.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
bobbanandClaude Sonnet 5 committed 2026-09-18 21:04:15 +02:00
1 parent 7564796c39
commit f2a6253ddf
6 files changed
+142 -19

No files matched your search

+5 -3
View File
@@ -201,6 +201,7 @@ interface DockhandSummary {
running: number;
total: number;
hostCount: number;
updatesAvailable: number;
stateBreakdown: { label: string; count: number }[];
}
@@ -323,6 +324,7 @@ export default function Dashboard({ user }: { user: CurrentUser }) {
running: res.summary.running,
total: res.summary.total,
hostCount: new Set(res.containers.map((c) => c.environmentName)).size,
updatesAvailable: res.containers.filter((c) => c.updateAvailable).length,
stateBreakdown: breakdownFrom(res.containers, (c) => c.state),
}),
)
@@ -607,9 +609,9 @@ export default function Dashboard({ user }: { user: CurrentUser }) {
</div>
<div className="col-4">
<MiniStat
label="Not running"
value={dockhandSummary!.total - dockhandSummary!.running}
accent={dockhandSummary!.total - dockhandSummary!.running > 0 ? "#f59e0b" : undefined}
label="Updates"
value={dockhandSummary!.updatesAvailable}
accent={dockhandSummary!.updatesAvailable > 0 ? "#f59e0b" : undefined}
/>
</div>
</div>