Skip to content

plugin-example-bootstrap

Version 2026.181.0001
Repo superproject
Plugin yes — see the plugin reference

Reference BOOTSTRAP-PHASE plugin (F9) — a compiled-in plugin declaring Phase=bootstrap, so the kernel invokes its OpBootstrap on the RAW project config bytes BEFORE config validation/migration (runBootstrapPhase, in LoadUnified before the schema gate). This no-op returns the bytes UNCHANGED, proving the bootstrap hook fires at the right time; a real bootstrap-phase plugin would transform a stale config’s bytes here. Bootstrap plugins are compiled-in only (no validated config exists yet to discover an out-of-process source). This candy is the phase machinery’s only consumer today: neither migrate nor egress became a bootstrap plugin (both are verb plugins).

This candy’s plan: — the runnable spec charly check executes against a live deployment. check: steps are idempotent probes; run: steps change state.

Intent Step
check the bootstrap-phase plugin ships a buildable Go module the host can compile in