clean personal info and private files from repository

- Remove personal hardware specs, machine-specific troubleshooting docs,
  and video transcript from assets/
- Remove stale PLAN-zfsbootmenu-implementation.org (feature complete)
- Remove .stignore (Syncthing config, not project-relevant)
- Untrack todo.org (personal task tracker with private infra details)
- Make archsetup path configurable via ARCHSETUP_DIR env var in build.sh
- Use $REAL_USER instead of hardcoded username in build-release scp

1 files changed, 0 insertions, 712 deletions

diff --git a/PLAN-zfsbootmenu-implementation.org b/PLAN-zfsbootmenu-implementation.org
deleted file mode 100644
index 6733c26..0000000
--- a/PLAN-zfsbootmenu-implementation.org
+++ /dev/null
@@ -1,712 +0,0 @@
-#+TITLE: ZFSBootMenu Implementation Plan
-#+AUTHOR: Craig Jennings & Claude
-#+DATE: 2026-01-22
-
-* Overview
-
-Replace GRUB bootloader with ZFSBootMenu in the archzfs installation script. ZFSBootMenu provides native ZFS snapshot booting, eliminates kernel/snapshot version mismatch issues, and simplifies the boot architecture.
-
-* Why ZFSBootMenu?
-
-| Feature         | GRUB                              | ZFSBootMenu                  |
-|-----------------+-----------------------------------+------------------------------|
-| Snapshot boot   | Custom scripts (grub-zfs-snap)    | Native, built-in             |
-| Kernel location | Separate /boot partition          | On ZFS with root             |
-| Rollback safety | Can mismatch kernel/snapshot      | Kernel travels with snapshot |
-| Boot menu       | Regenerate with grub-mkconfig     | Auto-discovers datasets      |
-| EFI size needed | ~1GB (kernels + GRUB)             | ~64MB (single binary)        |
-| Complexity      | High (scripts, hooks, generators) | Low (single binary + config) |
-
-* Current Architecture (GRUB)
-
-#+begin_example
-EFI Partition (1GB, /boot):
-├── EFI/
-│   └── GRUB/
-│       └── grubx64.efi
-├── grub/
-│   ├── grub.cfg
-│   └── fonts/
-├── vmlinuz-linux-lts
-├── initramfs-linux-lts.img
-└── initramfs-linux-lts-fallback.img
-
-ZFS Pool:
-└── zroot/
-    └── ROOT/
-        └── default (mountpoint=/)
-#+end_example
-
-* Target Architecture (ZFSBootMenu)
-
-#+begin_example
-EFI Partition (512MB, /efi):
-└── EFI/
-    └── ZBM/
-        └── zfsbootmenu.efi
-
-ZFS Pool:
-└── zroot/
-    └── ROOT/                              (org.zfsbootmenu:commandline set here)
-        └── default (mountpoint=/)         (bootfs property points here)
-            └── boot/                      <-- regular directory, NOT a dataset!
-                ├── vmlinuz-linux-lts
-                ├── initramfs-linux-lts.img
-                └── initramfs-linux-lts-fallback.img
-#+end_example
-
-*Key insight from research:* /boot is a regular directory inside ROOT/default,
-NOT a separate ZFS dataset. This ensures:
-1. Snapshots of ROOT/default include the matching kernel
-2. Rolling back a snapshot also rolls back to the kernel that was installed at that time
-3. ZFSBootMenu can find the kernel at the expected path
-
-* Files to Modify
-
-** custom/install-archzfs
-Primary installation script - most changes here.
-
-** build.sh
-ISO build script - remove GRUB snapshot tooling.
-
-** custom/grub-zfs-snap (DELETE)
-No longer needed - ZFSBootMenu handles natively.
-
-** custom/40_zfs_snapshots (DELETE)
-GRUB generator - no longer needed.
-
-** custom/zz-grub-zfs-snap.hook (DELETE)
-Pacman hook for GRUB - no longer needed.
-
-** custom/zfssnapshot
-Update to remove grub-zfs-snap call (ZFSBootMenu auto-detects).
-
-** custom/zfsrollback
-Update to remove grub-zfs-snap call.
-
-* Implementation Steps
-
-** Step 1: Update partition_disks()
-
-Location: custom/install-archzfs, lines 707-750
-
-Changes:
-- Reduce EFI partition from 1GB to 512MB
-- Update comments to reflect new purpose
-
-#+begin_src bash
-# Change this line:
-sgdisk -n 1:0:+1G -t 1:ef00 -c 1:"EFI" "$disk"
-
-# To:
-sgdisk -n 1:0:+512M -t 1:ef00 -c 1:"EFI" "$disk"
-#+end_src
-
-** Step 2: Update create_datasets()
-
-Location: custom/install-archzfs, lines 817-859
-
-*CRITICAL: DO NOT create a separate /boot dataset!*
-
-From research (PandaScience, sandreas/zarch, ZFSBootMenu docs):
-ZFSBootMenu expects /boot to be a *regular directory* inside the root dataset,
-NOT a separate ZFS dataset. The kernels must live at the path /boot/* within
-the root filesystem for ZFSBootMenu to find them.
-
-Changes:
-- Do NOT create a /boot dataset
-- The /boot directory will be created automatically by pacstrap when installing the kernel
-- This ensures snapshots of ROOT/default include the matching kernel
-
-#+begin_src bash
-# DO NOT ADD THIS - it's WRONG:
-# zfs create -o mountpoint=/boot "$POOL_NAME/ROOT/default/boot"
-
-# /boot is just a regular directory inside ROOT/default
-# mkinitcpio puts kernel/initramfs there automatically
-#+end_src
-
-Note: With ZFSBootMenu, kernels live ON the root ZFS dataset (not EFI partition).
-When you snapshot ROOT/default, the kernel is included in the snapshot.
-
-** Step 3: Replace mount_efi()
-
-Location: custom/install-archzfs, lines 861-867
-
-Changes:
-- Rename to mount_filesystems()
-- Mount EFI at /efi instead of /boot
-- /boot is already mounted as ZFS dataset
-
-#+begin_src bash
-mount_filesystems() {
-    step "Mounting Filesystems"
-
-    # EFI partition - only holds ZFSBootMenu binary
-    mkdir -p /mnt/efi
-    mount "${EFI_PARTS[0]}" /mnt/efi
-    info "EFI partition ${EFI_PARTS[0]} mounted at /mnt/efi"
-
-    # /boot is a directory inside the ZFS root dataset (created by pacstrap)
-    # No separate mount needed - it's part of the root filesystem
-}
-#+end_src
-
-** Step 4: Update install_base()
-
-Location: custom/install-archzfs, lines 869-920
-
-Changes:
-- Remove: grub, freetype2 (GRUB font support)
-- Keep: efibootmgr (needed for EFI boot entries)
-
-#+begin_src bash
-# Remove these from pacstrap:
-#   grub \
-#   freetype2 \
-
-# Keep efibootmgr
-#+end_src
-
-** Step 5: Update configure_system() fstab
-
-Location: custom/install-archzfs, lines 926-929
-
-Changes:
-- Mount EFI at /efi instead of /boot
-
-#+begin_src bash
-# Change:
-echo "UUID=$(blkid -s UUID -o value "${EFI_PARTS[0]}")  /boot  vfat  defaults,noatime  0 2"
-
-# To:
-echo "UUID=$(blkid -s UUID -o value "${EFI_PARTS[0]}")  /efi   vfat  defaults,noatime  0 2"
-#+end_src
-
-** Step 6: Update configure_initramfs()
-
-Location: custom/install-archzfs, lines 1021-1098
-
-Changes:
-- Update preset to use /boot (now on ZFS)
-- No changes to hooks - ZFS hook still needed
-
-The preset file paths remain the same (/boot/vmlinuz-linux-lts, etc.) but /boot is now on ZFS instead of EFI partition.
-
-** Step 7: Replace configure_bootloader() with configure_zfsbootmenu()
-
-Location: custom/install-archzfs, lines 1100-1164
-
-Delete the entire GRUB function and replace with:
-
-#+begin_src bash
-configure_zfsbootmenu() {
-    step "Configuring ZFSBootMenu"
-
-    # Ensure hostid exists and get value
-    # CRITICAL: Must be done BEFORE pool creation ideally, but we do it here too
-    if [[ ! -f /etc/hostid ]]; then
-        zgenhostid
-    fi
-    local host_id=$(hostid)
-
-    # Copy hostid to installed system (ZFS uses this for pool ownership)
-    cp /etc/hostid /mnt/etc/hostid
-
-    # Create ZFSBootMenu directory on EFI
-    mkdir -p /mnt/efi/EFI/ZBM
-
-    # Download ZFSBootMenu release EFI binary
-    # Using the bundled release which includes everything needed
-    # (Alternative: build from AUR with generate-zbm, but this is simpler)
-    info "Downloading ZFSBootMenu..."
-    local zbm_url="https://get.zfsbootmenu.org/efi"
-    if ! curl -fsSL -o /mnt/efi/EFI/ZBM/zfsbootmenu.efi "$zbm_url"; then
-        error "Failed to download ZFSBootMenu"
-    fi
-    info "ZFSBootMenu binary installed."
-
-    # Set kernel command line on the ROOT PARENT dataset
-    # This allows inheritance to all boot environments (future-proofing)
-    # ZFSBootMenu reads org.zfsbootmenu:commandline property
-    local cmdline="rw loglevel=3"
-
-    # Add any AMD GPU workarounds if needed (detect Strix Halo etc)
-    if lspci | grep -qi "amd.*display\|amd.*vga"; then
-        info "AMD GPU detected - adding workaround parameters"
-        cmdline="$cmdline amdgpu.pg_mask=0 amdgpu.cwsr_enable=0"
-    fi
-
-    # Set on ROOT parent so all boot environments inherit it
-    zfs set org.zfsbootmenu:commandline="$cmdline" "$POOL_NAME/ROOT"
-    info "Kernel command line set on $POOL_NAME/ROOT (inherited by children)"
-
-    # Set bootfs property - tells ZFSBootMenu which dataset to boot by default
-    zpool set bootfs="$POOL_NAME/ROOT/default" "$POOL_NAME"
-    info "Default boot filesystem set to $POOL_NAME/ROOT/default"
-
-    # Create EFI boot entries for each disk
-    # ZFSBootMenu EFI parameters (passed via --unicode):
-    #   spl_hostid=0x...     - Required for pool import
-    #   zbm.timeout=3        - Seconds before auto-boot (-1 = always show menu)
-    #   zbm.prefer=POOLNAME  - Preferred pool to boot from
-    #   zbm.import_policy=hostid - How to handle pool imports
-    local zbm_cmdline="spl_hostid=0x${host_id} zbm.timeout=3 zbm.prefer=${POOL_NAME} zbm.import_policy=hostid"
-
-    for i in "${!SELECTED_DISKS[@]}"; do
-        local disk="${SELECTED_DISKS[$i]}"
-        local label="ZFSBootMenu"
-        if [[ ${#SELECTED_DISKS[@]} -gt 1 ]]; then
-            label="ZFSBootMenu-disk$((i+1))"
-        fi
-
-        # Determine partition number (always 1 - first partition is EFI)
-        local part_num=1
-
-        info "Creating EFI boot entry: $label on $disk"
-        efibootmgr --create \
-            --disk "$disk" \
-            --part "$part_num" \
-            --label "$label" \
-            --loader '\EFI\ZBM\zfsbootmenu.efi' \
-            --unicode "$zbm_cmdline" \
-            --quiet
-    done
-
-    # Get the boot entry number and set as first in boot order
-    local bootnum=$(efibootmgr | grep "ZFSBootMenu" | head -1 | grep -oP 'Boot\K[0-9A-F]+')
-    if [[ -n "$bootnum" ]]; then
-        # Get current boot order, prepend our entry
-        local current_order=$(efibootmgr | grep "BootOrder" | cut -d: -f2 | tr -d ' ')
-        efibootmgr --bootorder "$bootnum,$current_order" --quiet
-        info "ZFSBootMenu set as primary boot option"
-    fi
-
-    info "ZFSBootMenu configuration complete."
-}
-#+end_src
-
-** Step 8: Delete configure_grub_zfs_snap()
-
-Location: custom/install-archzfs, lines 1166-1184
-
-Delete the entire function - ZFSBootMenu handles snapshot menus natively.
-
-** Step 9: Update sync_efi_partitions()
-
-Location: custom/install-archzfs, lines 1285-1315
-
-Changes:
-- Sync ZFSBootMenu binary instead of GRUB
-- Create EFI boot entries for secondary disks
-
-#+begin_src bash
-sync_efi_partitions() {
-    [[ ${#EFI_PARTS[@]} -le 1 ]] && return
-
-    step "Syncing EFI Partitions for Redundancy"
-
-    for i in "${!EFI_PARTS[@]}"; do
-        [[ $i -eq 0 ]] && continue
-
-        local efi_part="${EFI_PARTS[$i]}"
-        local temp_mount="/mnt/efi_sync"
-
-        info "Syncing ZFSBootMenu to EFI partition $((i+1)): $efi_part"
-
-        mkdir -p "$temp_mount"
-        mount "$efi_part" "$temp_mount"
-
-        # Copy ZFSBootMenu binary
-        mkdir -p "$temp_mount/EFI/ZBM"
-        cp /mnt/efi/EFI/ZBM/zfsbootmenu.efi "$temp_mount/EFI/ZBM/"
-
-        umount "$temp_mount"
-    done
-
-    rmdir "$temp_mount" 2>/dev/null || true
-    info "All EFI partitions synchronized."
-}
-#+end_src
-
-** Step 10: Update cleanup()
-
-Location: custom/install-archzfs, lines 1379-1393
-
-Changes:
-- Unmount /mnt/efi instead of /mnt/boot
-
-#+begin_src bash
-# Change:
-umount /mnt/boot 2>/dev/null || true
-
-# To:
-umount /mnt/efi 2>/dev/null || true
-#+end_src
-
-** Step 11: Update print_summary()
-
-Location: custom/install-archzfs, lines 1395-1424
-
-Changes:
-- Update bootloader references from GRUB to ZFSBootMenu
-- Update useful commands section
-
-#+begin_src bash
-# Update the "ZFS Features" section:
-echo "ZFS Features:"
-echo "  - ZFSBootMenu: boot from any snapshot"
-echo "  - Genesis snapshot: pristine post-install state"
-echo "  - Pre-pacman snapshots for safe upgrades"
-echo ""
-echo "Boot Menu Keys (at ZFSBootMenu):"
-echo "  Enter    - Boot selected environment"
-echo "  e        - Edit kernel command line"
-echo "  Ctrl+D   - Show snapshot selector"
-echo "  Ctrl+R   - Recovery shell"
-#+end_src
-
-** Step 12: Update build.sh
-
-Location: build.sh
-
-Changes:
-- Remove grub-zfs-snap file copies (lines ~375-380)
-- Remove grub-zfs-snap permissions (line ~408)
-- Keep bootloader configs for live ISO (still uses GRUB/syslinux)
-
-#+begin_src bash
-# DELETE these lines from build.sh:
-
-# Copy grub-zfs-snap to ISO
-cp custom/grub-zfs-snap profile/airootfs/usr/local/bin/grub-zfs-snap
-mkdir -p profile/airootfs/usr/local/share/grub-zfs-snap
-cp custom/40_zfs_snapshots profile/airootfs/usr/local/share/grub-zfs-snap/
-cp custom/zz-grub-zfs-snap.hook profile/airootfs/usr/local/share/grub-zfs-snap/
-
-# And from file_permissions:
-["usr/local/bin/grub-zfs-snap"]="0:0:755"
-#+end_src
-
-** Step 13: Update zfssnapshot and zfsrollback
-
-Location: custom/zfssnapshot, custom/zfsrollback
-
-Changes:
-- Remove calls to grub-zfs-snap
-- ZFSBootMenu auto-detects snapshots, no regeneration needed
-
-#+begin_src bash
-# DELETE from zfssnapshot (around line 107):
-grub-zfs-snap 2>/dev/null || true
-
-# DELETE from zfsrollback (around line 177):
-grub-zfs-snap 2>/dev/null || true
-#+end_src
-
-** Step 14: Delete GRUB-specific files
-
-Files to delete from custom/:
-- custom/grub-zfs-snap
-- custom/40_zfs_snapshots
-- custom/zz-grub-zfs-snap.hook
-
-#+begin_src bash
-rm custom/grub-zfs-snap
-rm custom/40_zfs_snapshots
-rm custom/zz-grub-zfs-snap.hook
-#+end_src
-
-** Step 15: Update main() function call order
-
-Location: custom/install-archzfs, main() around line 1443
-
-Changes:
-- Replace configure_bootloader with configure_zfsbootmenu
-- Remove configure_grub_zfs_snap call
-
-#+begin_src bash
-# Change this sequence:
-    configure_initramfs
-    configure_bootloader           # <- rename
-    configure_grub_zfs_snap        # <- delete
-    configure_zfs_services
-
-# To:
-    configure_initramfs
-    configure_zfsbootmenu          # <- new function
-    configure_zfs_services
-#+end_src
-
-* Testing Plan
-
-** Test Environment
-
-- QEMU VM with UEFI firmware (OVMF)
-- Multiple test scenarios for different disk configurations
-- Existing test script: scripts/test-vm.sh
-
-** Test 1: Single Disk Install
-
-#+begin_src bash
-# Start VM
-./scripts/test-vm.sh
-
-# In VM, run installer
-install-archzfs
-
-# Select single disk
-# Complete installation
-# Reboot
-#+end_src
-
-*Validation Points:*
-- [ ] EFI partition is 512MB (not 1GB)
-- [ ] /efi contains only EFI/ZBM/zfsbootmenu.efi
-- [ ] /boot is a directory (NOT a dataset): =zfs list= should NOT show zroot/ROOT/default/boot
-- [ ] Kernel files exist in /boot/ (=ls /boot/vmlinuz*=)
-- [ ] ZFSBootMenu menu appears on boot
-- [ ] Can boot into installed system
-- [ ] After login: =zfs get org.zfsbootmenu:commandline zroot/ROOT= shows cmdline (set on parent)
-- [ ] After login: =zpool get bootfs zroot= shows zroot/ROOT/default
-
-** Test 2: Mirror Install (2 disks)
-
-#+begin_src bash
-# Create second virtual disk
-qemu-img create -f qcow2 test-disk2.qcow2 50G
-
-# Modify test-vm.sh to add second disk
-# -drive file=test-disk2.qcow2,if=virtio
-
-# Run installer, select both disks, choose mirror
-#+end_src
-
-*Validation Points:*
-- [ ] Both disks have EFI partitions
-- [ ] ZFSBootMenu binary exists on both EFI partitions
-- [ ] EFI boot entries exist for both disks (efibootmgr -v)
-- [ ] Can boot from either disk (test by removing first disk)
-- [ ] ZFS pool shows mirror topology (zpool status)
-
-** Test 3: RAIDZ1 Install (3 disks)
-
-*Validation Points:*
-- [ ] All three disks have EFI partitions with ZFSBootMenu
-- [ ] Three EFI boot entries created
-- [ ] ZFS pool shows raidz1 topology
-
-** Test 4: Snapshot Boot
-
-#+begin_src bash
-# After installation and first boot:
-
-# Create a test file
-echo "original" > /root/test.txt
-
-# Create a snapshot
-zfs snapshot zroot/ROOT/default@test-snap
-
-# Modify the file
-echo "modified" > /root/test.txt
-
-# Reboot, at ZFSBootMenu press Ctrl+D
-# Select zroot/ROOT/default@test-snap
-# Boot from snapshot
-#+end_src
-
-*Validation Points:*
-- [ ] ZFSBootMenu shows snapshot selector with Ctrl+D
-- [ ] Snapshot appears in list
-- [ ] Booting from snapshot shows original file content
-- [ ] Kernel version matches (no mismatch errors)
-
-** Test 5: Kernel Update Scenario
-
-#+begin_src bash
-# Simulate kernel update (or actually do one)
-pacman -Syu
-
-# Reboot
-#+end_src
-
-*Validation Points:*
-- [ ] New kernel is on ZFS (included in future snapshots)
-- [ ] ZFSBootMenu detects and boots new kernel
-- [ ] No manual regeneration needed (unlike GRUB)
-
-** Test 6: Recovery Shell
-
-#+begin_src bash
-# At ZFSBootMenu, press Ctrl+R
-#+end_src
-
-*Validation Points:*
-- [ ] Recovery shell accessible
-- [ ] ZFS pool is importable from recovery
-- [ ] Can manually mount and chroot if needed
-
-** Test 7: Encrypted Pool
-
-#+begin_src bash
-# Run installer with encryption enabled
-# Enter passphrase when prompted
-#+end_src
-
-*Validation Points:*
-- [ ] ZFSBootMenu prompts for passphrase
-- [ ] Pool unlocks successfully
-- [ ] System boots normally after passphrase entry
-
-* Validation Checklist (All Tests)
-
-** Pre-Installation
-- [ ] Live ISO boots successfully
-- [ ] ZFS module loads (lsmod | grep zfs)
-
-** Partitioning
-- [ ] EFI partition is 512MB
-- [ ] ZFS partition uses remaining space
-- [ ] Partition table is GPT
-
-** Filesystem Layout
-- [ ] /efi is vfat, mounted from EFI partition
-- [ ] /boot is a directory inside ROOT/default (NOT a separate dataset)
-- [ ] Verify: =zfs list= should NOT show a zroot/ROOT/default/boot dataset
-- [ ] Kernel/initramfs exist in /boot/ (on the ZFS root filesystem)
-
-** ZFSBootMenu
-- [ ] zfsbootmenu.efi exists at /efi/EFI/ZBM/
-- [ ] EFI boot entry points to ZFSBootMenu
-- [ ] org.zfsbootmenu:commandline property set on root dataset
-- [ ] hostid included in cmdline (spl.spl_hostid=0x...)
-
-** Boot Process
-- [ ] ZFSBootMenu menu appears
-- [ ] Countdown timer works
-- [ ] Default boot entry is correct
-- [ ] Boot completes successfully
-- [ ] All ZFS datasets mount correctly
-
-** Multi-Disk (if applicable)
-- [ ] All EFI partitions contain zfsbootmenu.efi
-- [ ] All disks have EFI boot entries
-- [ ] Can boot from any disk
-
-** Snapshots
-- [ ] Genesis snapshot created
-- [ ] Ctrl+D shows snapshot selector
-- [ ] Can boot from snapshot
-- [ ] Snapshot includes matching kernel
-
-** Services
-- [ ] zfs-import-scan.service enabled
-- [ ] zfs-mount.service enabled
-- [ ] NetworkManager starts
-- [ ] SSH accessible (if enabled)
-
-* Rollback Plan
-
-If ZFSBootMenu implementation fails:
-
-1. Keep GRUB version in a git branch before changes
-2. ISO still boots with GRUB (live environment unchanged)
-3. Can install GRUB manually from live environment:
-   #+begin_src bash
-   pacstrap /mnt grub
-   arch-chroot /mnt grub-install --target=x86_64-efi --efi-directory=/boot
-   arch-chroot /mnt grub-mkconfig -o /boot/grub/grub.cfg
-   #+end_src
-
-* Research Findings (from comparable projects)
-
-This plan incorporates best practices from these open-source Arch+ZFS installers:
-
-** eoli3n/archiso-zfs + arch-config
-- ZFSBootMenu built from source with =generate-zbm= (we use pre-built binary for simplicity)
-- Uses file-based encryption key (=/etc/zfs/zroot.key=) embedded in initramfs to avoid double passphrase prompt
-- Sets =org.zfsbootmenu:commandline= on ROOT parent for inheritance to all boot environments
-- Minimal dataset layout: ROOT, data/home
-
-** PandaScience/arch-on-zfs
-- Uses rEFInd (not ZFSBootMenu), but documents the "smart dataset layout":
-  - =system/= for root, =userdata/= for home, =nobackup/= for cache/tmp
-- Emphasizes =canmount=noauto= on root dataset (we already do this)
-- Recommends =/boot= as directory inside root, NOT separate dataset
-
-** sandreas/zarch
-- Downloads ZFSBootMenu binary from =https://get.zfsbootmenu.org/latest.EFI= (adopted)
-- Uses efibootmgr =--unicode= parameter for ZFSBootMenu cmdline (adopted)
-- ZFSBootMenu parameters: =spl_hostid=, =zbm.timeout=, =zbm.prefer=, =zbm.import_policy= (adopted)
-- Uses zrepl for time-based snapshots (we use pacman hooks - complementary approach)
-
-** danboid/ALEZ
-- Two-pool design (bpool + rpool) for GRUB compatibility - NOT needed with ZFSBootMenu
-- systemd-boot ZFS entry uses =zfs=POOL/ROOT/default= parameter
-- Pool export/reimport pattern for clean state
-
-** danfossi/Arch-ZFS-Root-Installation-Script
-- Uses =compatibility=grub2= pool option for GRUB - NOT needed with ZFSBootMenu
-- Good partition suffix helper for nvme/mmcblk naming (we already have this)
-- Separate bpool for boot - NOT needed with ZFSBootMenu
-
-** Key Lessons Adopted
-
-1. *DO NOT create separate /boot dataset* - must be directory inside root
-2. *Set commandline on ROOT parent* - inherited by all boot environments
-3. *Use =--unicode= for ZFSBootMenu parameters* - spl_hostid, zbm.timeout, zbm.prefer
-4. *Download pre-built EFI binary* - simpler than building from AUR
-5. *Copy hostid to installed system* - required for pool import
-6. *Set bootfs pool property* - tells ZFSBootMenu default boot target
-
-** Optional Enhancement: File-Based Encryption Key
-
-From eoli3n: To avoid entering passphrase twice (ZFSBootMenu + initramfs):
-
-#+begin_src bash
-# During pool creation, use keylocation=file instead of prompt
-echo "$ZFS_PASSPHRASE" > /mnt/etc/zfs/zroot.key
-chmod 000 /mnt/etc/zfs/zroot.key
-
-# Add to mkinitcpio FILES
-echo 'FILES+=(/etc/zfs/zroot.key)' >> /mnt/etc/mkinitcpio.conf.d/zfs-key.conf
-
-# Change keylocation
-zfs set keylocation=file:///etc/zfs/zroot.key zroot
-#+end_src
-
-Trade-off: Simpler UX (one passphrase) but key is in initramfs on ZFS.
-*Current plan uses prompt-based* - user enters passphrase at ZFSBootMenu.
-
-* References
-
-** Official Documentation
-- ZFSBootMenu Documentation: https://docs.zfsbootmenu.org/
-- ZFSBootMenu GitHub: https://github.com/zbm-dev/zfsbootmenu
-- ZFSBootMenu man page: https://docs.zfsbootmenu.org/en/latest/man/zfsbootmenu.7.html
-- Arch Wiki ZFS: https://wiki.archlinux.org/title/ZFS
-
-** Researched Projects
-- eoli3n/archiso-zfs: https://github.com/eoli3n/archiso-zfs
-- eoli3n/arch-config: https://github.com/eoli3n/arch-config
-- PandaScience/arch-on-zfs: https://github.com/PandaScience/arch-on-zfs
-- sandreas/zarch: https://github.com/sandreas/zarch
-- danboid/ALEZ: https://github.com/danboid/ALEZ
-- danfossi/Arch-ZFS-Root-Installation-Script: https://github.com/danfossi/Arch-ZFS-Root-Installation-Script
-
-** Guides
-- Florian Esser's ZFSBootMenu Guide: https://florianesser.ch/posts/20220714-arch-install-zbm/
-- Arch Wiki ZFSBootMenu: https://wiki.archlinux.org/title/User:Kayvlim/Install_UEFI_and_BIOS_compatible_Arch_Linux_with_Encrypted_ZFS_and_ZFSBootMenu
-
-* Implementation Order
-
-1. Create git branch: =git checkout -b zfsbootmenu=
-2. Delete GRUB files (Step 14)
-3. Update build.sh (Step 12)
-4. Update install-archzfs (Steps 1-11, 15)
-5. Update helper scripts (Step 13)
-6. Build new ISO
-7. Run Test 1 (single disk)
-8. Fix any issues
-9. Run Tests 2-7
-10. Merge to main when all tests pass