Documentation
¶
Overview ¶
Command synapse-agent is the fleet VM agent (#410, epic #405). It enrols with the control plane's fleet API, then repeatedly heartbeats, claims host-inventory work orders, collects the host's facts and installed OS packages (reusing the engine's owned package cataloger), and reports the outcome. The private key is generated locally and never leaves the host; only a CSR is sent.
Scope for this issue: host facts + OS package inventory + the fleet transport loop. Listener/ service enumeration, local-config evaluation, source-tree scanning, and cgroup resource limits are deferred follow-ups, and Windows hosts are out of scope (documented in the collector).
It is a composition root only: no business logic lives here beyond wiring and the run loop, and the loop is exercised by main_test.go against a fake API.
Source Files