2efa9596

docs: a host reboot restores persistent guests

a73x 2026-08-06 09:12

Commit message

docs: a host reboot restores persistent guests

Proven on bare metal rather than reasoned: a host rebooted and a persistent
guest was running again on its original address within a minute of boot, while
an ephemeral guest on the same host was failed and left that way—which is the
designed distinction, now observed.

docs/assumptions.md

Old		New
@@ -29,6 +29,15 @@ with the same addresses. Underpins rolling agents to a live fleet at all.
29	Proven 2026-08-01 on bare metal: a guest created by the old agent survived	29	Proven 2026-08-01 on bare metal: a guest created by the old agent survived
30	the swap, kept its address, and stayed reachable through the gate.	30	the swap, kept its address, and stayed reachable through the gate.
31		31
		32	### A host reboot restores persistent guests, with their addresses
		33
		34	The boot identifier changes, every guest is detected lost, and persistent ones
		35	are restarted while ephemeral ones are failed and never resurrected. Underpins
		36	running anything you care about on a machine that reboots.
		37	Proven 2026-08-01 on bare metal: a host rebooted, and within a minute of
		38	boot a persistent guest was running again on the same address it held before,
		39	its disk intact—while an ephemeral guest on the same host was failed by design.
		40
32	### Old agents tolerate raw images	41	### Old agents tolerate raw images
33		42
34	`qemu-img convert -O raw` auto-detects its input, so a raw image is copied	43	`qemu-img convert -O raw` auto-detects its input, so a raw image is copied