--complete-with, la proyección NO es una StackSpec v2 válida para CUE, NO es un ResolvedPlan y NO autoriza la generación ni el despliegue. Completa primero las acciones manuales indicadas y pasa una StackSpec v2 completa por la resolución de CUE.
--complete-with acepta una StackSpec v2 completa y explícita, nunca una superposición parcial. Reconcilia los vínculos deterministas heredados de Site, nodo y hardware, y después usa la autoridad gobernada de Architecture v2 integrada. Un resultado completado contiene el candidato canónico explícito y el hash de su ResolvedPlan. La elegibilidad para el generador se informa de forma independiente de la validez de CUE y sigue la disposición del ResolvedPlan.
--inventory proporciona el Inventory observado contra el que resuelve la completación. Un Kit cuyo plan vincula hechos del nodo (Basement vincula la dirección del Site del nodo de su listener LAN) no puede resolverse sin él, y la completación nunca inventa esos datos.
--spec-output escribe la StackSpec v2 canónica completada exacta como JSON determinista. Solo es válido con --complete-with, nunca reescribe en el sitio por defecto y se niega a reemplazar un destino canónico existente; el reemplazo canónico requiere un flujo explícito de creación de StackSpec autorizado por CAS.
Un resultado listo para la resolución sombra termina con éxito. Un resultado bloqueado se emite igualmente como salida legible por máquinas y después el comando termina sin éxito. Context solo mapea la localidad heredada y el hardware Pi; nunca selecciona un Kit.
Ejemplos