Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Crates

NixFleet’s Rust workspace consists of 9 crates with clear separation of concerns. Each file in this directory is a one-screen mental model for one crate; for type signatures and method-level detail, follow the rustdoc link.

CrateOne-line summary
nixfleet-protoWire types: Serde-derived schema for every artefact and HTTP body.
nixfleet-canonicalizeJCS canonical JSON for signing - lean deps, no async runtime.
nixfleet-verify-artifactOffline auditor: verifies signed artefacts against trust roots.
nixfleet-state-machinePure per-host reducer (RFC-0005 §3); same code on agent + CP.
nixfleet-reconcilerPure decision procedure: reconcile, verify_artifact, planner gates.
nixfleet-releaseCI release tool: signs fleet.resolved.json + revocations sidecar.
nixfleet-cliOperator umbrella binary (nixfleet subcommands).
nixfleet-agentHost daemon: polls CP, fetches/applies closures, reports back.
nixfleet-control-planeAxum HTTP service + SQLite; routes signed intent to agents.