Roadmap
High-level direction for GuestKit / GuestCtl. Full release notes are in CHANGELOG.md.
Shipped (recent)
- v1.2.5 — Agent: freeze/thaw go through the privileged helper (online snapshots of PVC-backed VMs no longer fail), udev rule for the virtio channel, NBD allocate+connect lock, offline inject on
run_migrate_repair. - v1.2.4 — Docs: GitHub Release install,
zyvor-guestkiton PyPI, GHCR pins, serial console withoutgrubby. - v1.2.3 — Serial console without
grubby(grub2, BLS, syslinux, extlinux, zipl). XFS remount, real guest/resolution, Windows root mounted read-write for offlineguestkitdinject. Python package iszyvor-guestkiton the zyvor account. GHCR isghcr.io/zyvorai. - v1.2.2 — Web Image Vault TUI parity (inspect, Assurance, Profiles, Files) and
POST /api/v1/vms/:id/profile/explore. - v1.2.0 — GuestKit-assured QEMU/VirtIO runtime (
guestkit-qemu plan|run|qmp) — evidence → boot gate → QEMU argv + QMP day-2 control; see qemu-runtime.md. Dumpvirshfrom the live QGA path (guestkit qga) — virsh-to-guestkit.md. - v1.1.0 — Python assurance bindings (
run_doctor/run_migrate_repair), h2kvm offline fixer integration. The PyPI name is nowzyvor-guestkit(washypersdk-guestkit). - v1.0.0 — GitHub Action for the Passport CI gate (
action.yml, dogfooded bypassport-gate-demo.yml); CI reliability pass (missinglibsystemd-dev/libhivex-devon Linux runners, loop/NBD device permissions, stale RPM spec version, doc-test compile fixes, k3s E2E musl/mingw/MinIO credential fixes,zyvor-apimTLS bootstrap-token crash-loop); Helm chart CI (helm lint/templateacross all real overlays) and a manual-dispatch workflow for the NBD tests hosted runners can't run; native OpenAI tool-calling (rig-core), cross-run AI memory, and an MCP server for the AI copilot (guestkit mcp-serve); fleet dependency-aware migration waves (fleet wave-plan) and scheduled drift monitoring against a stored baseline (fleet watch) - v0.3.21 — Fixed
rescue -o reset-passwordSEGV (hivex_value_typeFFI signature);ntfsfixnow actually clears the NTFS dirty flag; fixed Windows cross-compile break from ungated Unix-only guestfs modules - v0.3.20 — DevOps runbooks + wiki; package mirror; Windows AES SAM / domain-leave RunOnce; UEFI fix-grub; host package fetch; worker profiles
- v0.3.19 — Cutover Passport (
passport emit|verify, BitLocker hard-block, live attestation, HyperSDK/hyper2kvm suite handoff); Windows day-0windows-domain-leave/windows-timezone/windows-static-ip - v0.3.18 — Day-0 plans (
windows-hostname,windows-winrm, hardenedlinux-ssh+ key inject),Symlink/FileDeleteops, Windows SAM blank rescue,rescue --export-plan, offlineDriverInjectviaGUESTKIT_VIRTIO_WIN/migrate-repair --virtio-win, heuristic offline remediations + preview live-only tags - v0.3.12 — Offline Windows registry writes in fix-plan apply (
registry-writefeature, libhivex FFI) - v0.3.11 — Guest Control Fabric (7-tier ladder,
guest/*APIs, Agent Doctor, airgap poll) - v0.3.7–0.3.10 —
zyvor-guest-agent, Windows forensics, KubeVirt QGA, web Copilot API, k3s E2E - v0.3.6 — In-guest agent, offline
--inject-agent, worker jobs, TUI LIVE / Assurance - v0.3.5 — Migration assurance platform (
doctor,migrate-plan,policy,fleet,forensic-diff) - v0.3.3–0.3.4 —
guestctlbinary, user release tarballs, TUI theming - v0.3.1 — VM migration (fstab/crypttab rewriter), Windows registry detection, LVM cleanup
AI Guest Agent (all phases shipped)
Phases 0–4 of the optional AI layer are complete — richer systemd/Windows evidence, semantic analysis, the agentic loop (now with native rig-core tool-calling for OpenAI and cross-run memory), local Ollama + what-if simulation, and platform integration (CIS-lite profiles, Machina export, full .evtx forensics, an MCP server for external hosts). See ai-guest-agent-roadmap.md.
In progress / next
The previously tracked Unreleased slices (Passport signing, day-0/rescue, GCF telemetry, Helm, Windows depth, fleet parallel, cloud pulls, AES SAM, PackageInstall fetch, GRUB repair) are shipped in Unreleased. Next work is issue-driven — pick from GitHub Issues or propose a small PR.
Parked (later)
None currently.
Not planned (open source)
- Hosted control plane (see zyvor-enterprise.md)
- Automatic apply without dry-run/backup guardrails
How to contribute
Pick an item from GitHub Issues or propose a small PR with tests. See CONTRIBUTING.md.
Docs
- User guides: docs/INDEX.md
- Fix plans / rescue: fix-plans.md
- QEMU runtime: qemu-runtime.md
- Dump virsh: virsh-to-guestkit.md
- CLI cheat sheet: quick-reference.md
- TUI: tui-enhancements.md