plugin-vm
| Version | 2026.177.0400 |
| Repo | superproject |
| Plugin | yes — see the plugin reference |
The VM subsystem relocated into a COMPILED-IN plugin candy (P10). It provides TWO
capabilities: verb:libvirt — the libvirt live check verb (list, info, screenshot,
send-key, QMP, qemu-guest-agent, snapshots, events) plus the internal VM-resolution ops
(resolve-target / domain-state / list-domains the host’s spice/vnc/ssh/status/preempt
consumers call), dispatched through the provider registry; and command:vm — the
charly vm … lifecycle CLI (build / create / start / stop / destroy / console / ssh /
snapshot / gpu / import / clone / cp-box / list), COMPILED-IN and dispatched IN-PROC via
Invoke(OpRun), so its handlers run in charly’s own process (native stdio/TTY for
console/ssh). The handlers own the CLI + the libvirt/qemu engine in-package and reach the
host-only Mechanisms over generic seams: the config loader + deploy-ledger READ via
HostBuild(“config-resolve”), the deploy-ledger WRITE plugin-side via
deploykit.SaveVmDeployState/RemoveVmDeployEntry directly (#55 coneC-dsh β2 — the
config-persist host seam is deleted), the VM-disk build engine plugin-side
(candy/plugin-vm/vm_build_resolve.go — the former HostBuild(“vm-build”) is deleted),
egress via verb:egress, preempt via verb:arbiter, GPU via verb:gpu.
All of it is backed by go-libvirt + kata-containers/govmm + libvirt.org/go/libvirtxml,
compiled into charly for this canonical placement. The libvirt: verb dispatches through
the provider registry exactly like a built-in (the libvirt: <method> sugar desugars to
plugin/plugin_input — the method + every libvirt-exclusive modifier ride the input map,
validated against this plugin’s own #LibvirtInput; authoring unchanged), running the
LibvirtCmd Kong tree IN this plugin’s process.
Acceptance plan
Section titled “Acceptance plan”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 libvirt verb dispatches through the external vm plugin and lists the libvirt domains for a live VM deployment |