Validation Gates
HostShift release candidates must pass more than unit tests.
Fast Gates
Section titled “Fast Gates”make test-gomake buildmake test-integration-dockermake test-e2e-vmmake release-snapshotDocker Matrix
Section titled “Docker Matrix”Run the real SSH-driven Docker matrix:
HOSTSHIFT_RUN_DOCKER_MATRIX=1 make test-integration-dockerThe matrix verifies cross-distro migrations, source immutability markers, file copy, MySQL restore, PostgreSQL restore, HTTP health, Laravel-style DB connectivity, and checksum assertions.
VM Apply Gate
Section titled “VM Apply Gate”Run the real Lima VM apply matrix locally or on the self-hosted hostshift-vm macOS runner:
HOSTSHIFT_RUN_VM_E2E=1 bash tests/e2e/vm/run-vm-e2e.sh --applyThe VM gate covers package installation, systemd behavior, firewall state, boot persistence, database parity, HTTP health, and source checksum immutability.
Release Artifacts
Section titled “Release Artifacts”make release-snapshot must produce:
dist/hostshiftdist/checksums.txtdist/hostshift.sbom.spdx.json
Tagged releases also upload signed checksum artifacts and GitHub artifact provenance attestations.