# hiperiso architecture notes

This file is a short local design note for the current implementation.

- USB media uses two partitions:
  - partition 1: data partition for ISOs, logs, and configuration
  - partition 2: FAT EFI partition for GRUB, kernel, initramfs, and firmware payloads
- The EFI boot path is:
  - firmware → `EFI/BOOT/BOOTX64.EFI`
  - GRUB loads `grub/grub.cfg`
  - the custom module boots the host kernel and initramfs from `EFI/hiperiso/`
  - the initramfs starts QEMU/KVM and boots the selected ISO as a guest
- Secure Boot is only considered supported when a real signed shim asset is packaged.
- The build should prefer locally maintained `src/grub2/` sources over broad source-tree rewrites.