← Back to list
01Issue
FeatureClosedSwamp ClubPublic
AssigneesNone
Relationships
#3403 Docs: dashboard reference needs the Workers view (/dashboard/workers)
Opened by swamp_lord · 10/13/2026
swamp-club#3356 (swamp PR #3078) adds a Workers view to the swamp serve --dashboard SPA at /dashboard/workers, and the manual doesn't cover it yet.
Pages to update
content/manual/reference/swamp-serve/dashboard.md- The URL patterns table needs a
/dashboard/workers→ Workers row. - A short Workers section next to Schedules and Approvals:
- Grouping: remote-execution workers are grouped by the
fleetlabel (the enrollment token), any other label key, or platform/arch, in a treemap weighted by slot capacity. - Workers: each worker is a square sized by
capacity, with one cell per dispatch slot showing that slot's step lease. A slot is green while its lease is active, then shows completed, failed or expired before it frees. - Status outlines: busy workers are outlined green, draining orange and disconnected red.
- Visibility TTL: disconnected workers stay visible for a TTL the viewer can adjust (default 2h, at most 24h, the worker GC default).
- Placement selector: you type
labels,platformortargetthe way a step's placement block does. Workers the step wouldn't reach are dimmed, and the view shows how many workers match and how many free slots they have. - Slot links: each slot row links to the workflow run it is serving.
- Access: the view needs an admin grant on
access, the same asswamp worker list.
- Grouping: remote-execution workers are grouped by the
- The Overview description should mention the header's
Workers │ busy · idle · unavailablesummary, which links to the Workers view.
- The URL patterns table needs a
content/manual/how-to/worker-fleets.mdandreference/remote-execution.md: one line pointing to the Workers view as the visual way to inspect the pool alongsideswamp worker list.
Reference behaviour for writers
design/primitives/serve.md, the Workers view bullet.design/enablers/remote-execution.md, Worker state is swamp data.- The JSON output of
swamp worker listnow also includestokenNameanddisconnectedAt. Both fields are additive.
02Bog Flow
Closed
No activity in this phase yet.
03Sludge Pulse
Editable. Press Enter to edit.
stack72 commented 10/14/2026, 12:48:36 AM
Fixed in swamp-club#1339: reference/swamp-serve/dashboard has the /dashboard/workers route and a Workers section; worker-fleets and remote-execution point to the Workers view; worker-commands documents tokenName/disconnectedAt.
Sign in to post a ripple.