fruix/docs/reports/phase17-source-revision-boots-freebsd.md

Phase 17.2: boot systems from distinct declared FreeBSD source revisions

Date: 2026-04-03

Goal

Phase 17.2 extends Phase 17.1 from:

• side-by-side source-driven builds

to:

• side-by-side source-driven boots.

The important requirement was not visible runtime behavior differences between the guests. The requirement was that Fruix should be able to:

• build bootable systems from at least two distinct declared source revisions
• boot both systems with the validated native base path
• preserve source identity in the resulting system/image metadata

Implementation

Added boot validation harness:

• tests/system/run-phase17-source-revisions-qemu.sh

This script renders the Phase 17 source templates from Phase 17.1 and then boots two systems under the already-validated QEMU/UEFI/TCG path:

• Git-backed source:
  • ref: stable/15
  • pinned commit: 332708a606f6bf0841c1d4a74c0d067f5640fe89
• release archive source:
  • https://download.freebsd.org/releases/amd64/15.0-RELEASE/src.txz
  • sha256:
    • 83c3e8157b6d7afcae57167fda75693bf1e5f581ca149a6ecb2d398b71bdfab0

The harness reuses:

• tests/system/run-phase11-shepherd-pid1-qemu.sh

and checks both guest runtime behavior and image/build provenance metadata.

Validation

Passing run:

• PASS phase17-source-revisions-qemu

Confirmed booted systems from two distinct source identities:

git_closure=/frx/store/d6cbcc76f57fa9c392a80fe20e7499f7a837aab4fb96ea056e624cde95bc70c8-fruix-system-fruix-freebsd
txz_closure=/frx/store/02268e19930facb32e12b6ec191f2e5704d1e81033baf3637a889ad15924ff88-fruix-system-fruix-freebsd

Confirmed source metadata recorded in image/build artifacts:

git_source_kind=git
git_source_ref=stable/15
git_source_commit=332708a606f6bf0841c1d4a74c0d067f5640fe89
git_materialized_source_store=/frx/store/c9928605fa906b90a600dafeebe5005dd18ad3b8e62b7111d9d13ad60ee56490-freebsd-source-stable15-side-a

txz_source_kind=src-txz
txz_source_url=https://download.freebsd.org/releases/amd64/15.0-RELEASE/src.txz
txz_source_sha256=83c3e8157b6d7afcae57167fda75693bf1e5f581ca149a6ecb2d398b71bdfab0
txz_materialized_source_store=/frx/store/5eaeff5c6c55a95b6531d9cf2e1824cd4368d81c614608426bee1a5d2a664dc5-freebsd-source-release15-side-b

Confirmed distinct native base outputs used by the two boots:

git_native_base_stores=/frx/store/4b615431ec25c500a3bf0ed70ce39e2ebf4f584994a53756268e4383962bc86b-freebsd-native-kernel-15.0-source-side-by-side,/frx/store/3a5a0b2b88b4757cf9cb4e3040f992d8fdb5bd9a7f1b186da983854cd95392c5-freebsd-native-bootloader-15.0-source-side-by-side,/frx/store/177f78e7f2932986a380187eb09dc34cc2cd9a146c5ed1fe1f00aae15ddf78d9-freebsd-native-runtime-15.0-source-side-by-side

txz_native_base_stores=/frx/store/0c5141a86fa9c1974102f2bd8766eb3ab787b97dcccb71f17d80aefbe8ed4f3e-freebsd-native-kernel-15.0-source-side-by-side,/frx/store/3de6592f50a735d8461662cb393fc413325ce24ded45d4bb494525896f8cb5eb-freebsd-native-bootloader-15.0-source-side-by-side,/frx/store/46d256305198ee7d745b9032c71085aba97d55fdf7a0d3d2017dd4455173205d-freebsd-native-runtime-15.0-source-side-by-side

Confirmed both guests booted successfully through the validated PID 1 path:

• Shepherd ran as PID 1 in both boots
• sshd was running in both boots
• boot backend:
  • qemu-uefi-tcg

Validation artifacts:

• Git serial log:
  • /tmp/fruix-phase17-source-qemu.7Za50q/git/serial.log
• src.txz serial log:
  • /tmp/fruix-phase17-source-qemu.7Za50q/txz/serial.log

Result

Phase 17.2 is complete.

Fruix now boots systems built from at least two distinct declared FreeBSD source revisions while preserving those source identities in system/image metadata.

That means Phase 17 is no longer just about build-time coexistence. The validated native boot path now also works across distinct source identities.