Fleet Management | LumenFlow

Monitor connected-runtime inventory, drift detection, policy distribution, and authority modes.

What fleet management provides#

Fleet management gives operators visibility into all connected runtimes enrolled in a workspace — their health, version compatibility, policy drift, and authority posture.

Fleet inventory#

Query fleet state with GET /api/v1/workspaces/{id}/fleet. The response includes:

Field	Description
`runtimes`	Array of enrolled runtimes with health, version, and drift status
`summary`	Aggregate counts (active, stale, dormant, upgrade required)
`desiredState`	Current workspace config revision and policy mode

Drift detection#

Drift compares desired state (workspace config) against observed state (what each runtime last reported):

Drift Status	Meaning
aligned	Config revision matches, version is full-sync compatible
needs_reconcile	Config revision differs — runtime should pull latest
upgrade_required	Runtime version below minimum supported (3.4.0)
awaiting_sync	Enrolled but no heartbeat received yet

warning Drift detection is v1: it compares against a computed hash of current workspace config, not a tracked deployment version. Config edits immediately trigger needs_reconcile. Tracked deployment versions are a planned follow-on.

Policy distribution#

Connected runtimes pull desired-state configuration from GET /api/v1/workspaces/{id}/fleet/config:

distribution_mode: always pull (runtimes fetch, cloud doesn't push)
config_path and policies_path: canonical fetch endpoints
activePolicies: org-scoped and workspace-scoped policy rules

Authority modes#

Each workspace operates in an authority mode:

Mode	Behavior
Authoritative	Cloud config overrides local runtime config
Tighten-only	Cloud can tighten but not loosen local policy
Dev Override	Local runtime config takes precedence (development only)

Runtime health#

Health is derived from heartbeat freshness:

Status	Threshold
Connected	Heartbeat < 5 minutes ago
Stale	5–60 minutes ago
Dormant	> 60 minutes ago
Never	No heartbeat received

Dashboard#

The Observe page at /dashboard/observe shows fleet rollout posture across all accessible workspaces with authority, drift, and health badges.