Architecture

Provium's architecture — a Go host binary with an embedded Lua runtime drives a C agent inside a QEMU/KVM virtual machine over vsock.

The binary message protocol between the host and guest agent — message framing, types, and payload formats.

The guest agent is a statically-linked C binary that runs inside the VM, executing commands and syscalls on behalf of the host.

How Provium saves and restores VM state using QEMU's migration mechanism to make fixture-based testing fast.