feat(api): add ImpVM.spec.snapshotRef for snapshot-based boot

Author: syscod3

api/v1alpha1/impvm_types.go

@@ -51,6 +51,14 @@ type ImpVMSpec struct {
 	// +optional
 	NodeName string `json:"nodeName,omitempty"`
 
+	// SnapshotRef names the child ImpVMSnapshot execution to restore this VM from.
+	// When set, the agent configures Firecracker to boot from the snapshot files
+	// rather than a fresh image. The snapshot must be in the same namespace as the VM.
+	// Used by ImpWarmPool (pool members boot from elected base snapshot) and
+	// ImpVMMigration (target VM restores source VM state).
+	// +optional
+	SnapshotRef string `json:"snapshotRef,omitempty"`
+
 	// NodeSelector constrains scheduling to nodes matching all labels.
 	// Same semantics as Pod.spec.nodeSelector.
 	// +optional

api/v1alpha1/impvm_types_test.go

@@ -76,6 +76,20 @@ func TestImpVMStatus_exhaustedAt(t *testing.T) {
 	assert.Equal(t, int32(5), out2.RestartCount)
 }
 
+func TestImpVM_snapshotRef_roundTrip(t *testing.T) {
+	vm := ImpVM{
+		Spec: ImpVMSpec{
+			Image:       "busybox:latest",
+			SnapshotRef: "snap-parent-20260306-120105",
+		},
+	}
+	b, err := json.Marshal(vm)
+	require.NoError(t, err)
+	var out ImpVM
+	require.NoError(t, json.Unmarshal(b, &out))
+	assert.Equal(t, "snap-parent-20260306-120105", out.Spec.SnapshotRef)
+}
+
 func TestRestartPolicy_roundTrip(t *testing.T) {
 	rp := RestartPolicy{
 		Mode:           "reschedule",

api/v1alpha1/shared_types.go

@@ -4,6 +4,9 @@ const (
 	// LabelSnapshotParent is the label key on child ImpVMSnapshot execution objects
 	// that identifies their parent ImpVMSnapshot (the schedule/config object).
 	LabelSnapshotParent = "imp.dev/snapshot-parent"
+
+	// LabelWarmPool is the label key applied to ImpVM objects that belong to a warm pool.
+	LabelWarmPool = "imp.dev/warm-pool"
 )
 
 // LocalObjectRef is a reference to an object in the same namespace.

api/v1alpha1/zz_generated.deepcopy.go

@@ -539,6 +539,14 @@ spec:
                     - cool-down
                     type: string
                 type: object
+              snapshotRef:
+                description: |-
+                  SnapshotRef names the child ImpVMSnapshot execution to restore this VM from.
+                  When set, the agent configures Firecracker to boot from the snapshot files
+                  rather than a fresh image. The snapshot must be in the same namespace as the VM.
+                  Used by ImpWarmPool (pool members boot from elected base snapshot) and
+                  ImpVMMigration (target VM restores source VM state).
+                type: string
               templateRef:
                 description: TemplateRef references an ImpVMTemplate. Mutually exclusive
                   with ClassRef.

config/crd/bases/imp.dev_impvms.yaml

@@ -66,8 +66,11 @@ spec:
                 format: int32
                 type: integer
               snapshotRef:
-                description: SnapshotRef names the ImpVMSnapshot to boot pool members
-                  from.
+                description: |-
+                  SnapshotRef names the ImpVMSnapshot parent to boot pool members from.
+                  The pool controller uses status.baseSnapshot on the referenced object
+                  to resolve the elected execution artifact. The pool stays idle until
+                  a base snapshot has been elected via `kubectl imp elect`.
                 type: string
               templateName:
                 description: TemplateName is the ImpVMTemplate used to create pool