PaganOS Luna 0.6.0
PL EN DE
🔒 Repository is read-only – file editing is disabled.

PaganLinux/build-pagan-v2.sh main

2476 lines Raw ← Back
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476
#!/bin/bash
# =============================================================================
# build-pagan-v2.sh – NOWY silnik budowania Pagan Linux (rolling, od zera)
# =============================================================================
# FILOZOFIA (dlaczego osobny silnik):
#   Stary build-pagan.sh kompiluje cały LFS/BLFS ze źródeł (godziny, setki
#   zależności, ryzyko rozjazdu ABI). Tymczasem repozytorium PAG w
#   https://repo.paganlinux.eu/stable/ ma ~1900 gotowych pakietów – w tym JĄDRO
#   (kernel), systemd, NetworkManager, PipeWire+WirePlumber, całe XFCE4,
#   LightDM, GRUB i sterowniki NVIDIA. Ten silnik stawia więc system WPROST
#   z repo:
#
#       1) bootstrap rootfs: pobiera kilka fundamentalnych paczek .pag
#          (glibc, bash, python, pag, gnupg…) i rozpakowuje ich data.tar.xz,
#       2) w chroocie robi `pag update` + `pag install <cały stack>`,
#       3) konfiguruje usługi (sieć/dźwięk/display), GRUB, initramfs, NVIDIA,
#       4) pakuje ISO/IMG sprawdzonym kodem z build-pagan.sh (source).
#
#   Efekt: system działający „od GRUB-a po sieć i dźwięk”, XFCE4 jako domyślne
#   środowisko i sterowniki NVIDIA, a wszystko w modelu ROLLING (aktualizacje
#   przez `pag upgrade`, bez nowego ISO).
#
# FORMAT PACZKI .pag (to na tym opiera się bootstrap):
#   <nazwa>.pag              = tar.xz
#     ├── metadata.json      – nazwa, wersja, zależności
#     ├── data.tar.xz        – drzewo plików + sums.json
#     └── hooks/             – opcjonalne hooki
#
# UŻYCIE (wymaga roota, sieci i hosta z: python3, wget, xorriso, mksquashfs,
# syslinux, mtools, dosfstools, e2fsprogs):
#   sudo ./build-pagan-v2.sh                       # XFCE4 + ISO (rolling)
#   sudo ./build-pagan-v2.sh --wizard              # kreator: pola wyboru (TTY)
#   sudo ./build-pagan-v2.sh --plan                # plan + opis GRUB/initramfs/jądra
#   sudo ./build-pagan-v2.sh --name "Pagan Linux" --version "1.0.0 Rolling"
#   sudo ./build-pagan-v2.sh xfce both             # XFCE4 + IMG i ISO
#   sudo ./build-pagan-v2.sh luna iso              # Luna (Selene + libLuna)
#   sudo ./build-pagan-v2.sh luna iso --name Luna  # rootfs/ISO w /home/luna
#   sudo ./build-pagan-v2.sh xfce iso --no-nvidia  # bez NVIDIA
#   sudo ./build-pagan-v2.sh xfce iso --rebuild    # od zera (czyści rootfs)
#   sudo ./build-pagan-v2.sh --check               # tylko weryfikacja (paczek/repo)
#   sudo ./build-pagan-v2.sh xfce iso --publish \
#        --remote user@vps:/var/www/repo.paganlinux.eu/stable
#
# DODATKOWE OPCJE UI:
#       --name NAZWA       Nazwa systemu (os-release, GRUB, nazwy artefaktów)
#       --version WERSJA   Wersja systemu (np. "1.0.0 Rolling")
#   -i, --interactive     kreator z polami wyboru (pyta też o nazwę/wersję;
#                         uruchamia się sam bez arg. na terminalu)
#   -y, --non-interactive buduj od razu z wartościami domyślnymi/CLI
#   -q, --quiet           mniej komunikatów (pełny log nadal w $LOG_FILE)
#   -v, --verbose         pokazuj na konsoli pełny log długich komend
#       --no-anim         wyłącz spinner/animacje (przydatne w CI i logach)
#       --plan, --dry-run pokaż plan budowy i zakończ (bez zmian w systemie)
#       --no-initramfs-tool  nie instaluj pagan-initramfs do obrazu (debug)
#       --root DIR         Katalog rootfs (domyślnie wybierany automatycznie:
#                          /home/<user>/pagan-build/rootfs, gdy /home to osobna
#                          partycja z miejscem; w przeciwnym razie /mnt/pagan)
#       --work-dir DIR     Cache buildera (domyślnie obok rootfs na /home)
#   Zmienne: PAGAN_BUILD_DIR (katalog bazowy), PAGAN_MIN_FREE_GB (próg, 30)
#
# UWAGA: silnik jest nastawiony na REPO. Jeśli chcesz zbudować ISO bez sieci,
# użyj starego build-pagan.sh (kompilacja ze źródeł).
# =============================================================================
# ADNOTACJA (2026-10-08) – INSTALATOR
#   Instalatorem Pagan jest WŁASNY `pagan-install` (TUI). Calamares USUNIĘTY
#   ze stacku tego buildera — instalator dostarcza build-pagan.sh (funkcja
#   install_pagan_installer(); tu wołana z _phase_pack i z finalize_build).
#
#   Live:   pagan-welcome + `pagan-install` (partycjonowanie, LUKS, dual-boot,
#           użytkownik, bootloader, wybór grup pakietów).
#   Wybory: edycja / DE / oprogramowanie = GRUPY metapakietów (pagan-group-*,
#           pagan-de-*), instalowane przez `pag install` w chroot.
# =============================================================================
set -Eeuo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
cd "$SCRIPT_DIR"

# Konfiguracja powłok (bash + zsh + podpowiedzi AI). Współdzielona z v1, bo
# v2 nie source'uje build-pagan.sh do fazy pakowania, a powłoki trzeba
# skonfigurować wcześniej (_phase_configure).
# shellcheck source=pagan-shells.sh
if [[ -f "$SCRIPT_DIR/pagan-shells.sh" ]]; then
    source "$SCRIPT_DIR/pagan-shells.sh"
fi

# ========================= KONFIGURACJA =========================
# Puste = wybór automatyczny w _pick_build_location (patrz niżej).
PAGAN_ROOT="${PAGAN_ROOT:-}"
# Czy nazwa przyszła z --name/env (wtedy NIE dopisujemy środowiska).
PAGAN_NAME_EXPLICIT=0
[[ -n "${PAGAN_NAME:-}" ]] && PAGAN_NAME_EXPLICIT=1
PAGAN_NAME="${PAGAN_NAME:-Pagan Linux}"
PAGAN_VERSION="${PAGAN_VERSION:-0.6.0 Rolling}"
PAGAN_FILE_PREFIX="${PAGAN_FILE_PREFIX:-}"
export PAGAN_CHANNEL="${PAGAN_CHANNEL:-rolling}"
PAGAN_DE="${PAGAN_DE:-luna}"
# Repo bez końcowego „/” – pag i tak normalizuje.
PAGAN_REPO_URL="${PAGAN_REPO_URL:-https://repo.paganlinux.eu/stable}"
# Puste = <katalog systemu>/ISO, np. /home/pagan-linux/ISO (patrz _pick_build_location).
OUTPUT_DIR="${OUTPUT_DIR:-}"
# Puste = obok rootfs (gdy budujemy na /home) albo /var/cache/pagan-build.
WORK_DIR="${WORK_DIR:-}"
REPO_CACHE=""
BOOTSTRAP_CACHE=""
LOG_FILE="${LOG_FILE:-/var/log/pagan-build-v2.log}"
BUILD_LOCATION_NOTE=""

ARTIFACT="iso"        # iso | img | both
REBUILD=0             # --rebuild: czyść rootfs i bootstrap
NO_NVIDIA=0
PUBLISH=0
REMOTE="${REMOTE:-}"
SKIP_BOOTSTRAP=0      # --reuse-rootfs: użyj istniejącego $PAGAN_ROOT
CHECK=0               # --check: tylko weryfikacja (bez budowy)

# ── UI / kreator ─────────────────────────────────────────────────────────────
INTERACTIVE=0         # --wizard / --interactive
NONINTERACTIVE=0      # --non-interactive / --yes
QUIET=0               # --quiet
VERBOSE=0             # --verbose
SHOW_PLAN=0           # --plan / --dry-run
NO_INITRAMFS_TOOL=0   # --no-initramfs-tool (debug)
PB_ANIM="${PAGAN_ANIM:-1}"

# ── Cały „działający stack” instalowany z repo ───────────────────────────────
# Uwaga: `xfce4` to meta-pakiet (pociąga panel, sesję, xfwm4, thunar, tumbler,
# lightdm…), więc nie wymieniamy wszystkich pod-pakietów. `nvidia-dkms`
# i `nvidia-kernel` dokładamy osobno (userland + moduły jądra).
STACK_BASE=(
    # jądro + firmware + rozruch
    kernel linux-firmware grub os-prober efibootmgr busybox findutils
    dosfstools mtools squashfs-tools
    # fundament systemu
    # gcc/make/binutils/pkg-config: potrzebne DKMS (NVIDIA/VirtualBox) po
    # `pag upgrade kernel` na zainstalowanym systemie – bez nich moduły
    # out-of-tree nie przebudują się.
    gcc make binutils pkgconf
    systemd dbus polkit shadow sudo util-linux kmod
    e2fsprogs xfsprogs btrfs-progs lvm2 cryptsetup mdadm
    tzdata ca-certificates nss nss-mdns
    # sieć (przewodowa + Wi-Fi) = „od GRUB-a po sieć”
    networkmanager network-manager-applet wpa-supplicant iw rfkill
    wireless-regdb dhcpcd iproute2
    # dźwięk = „…i dźwięk” (PipeWire + sesja)
    #   • alsa-ucm-conf – profile UCM (JACK/mikrofon/głośniki w laptopach);
    #     bez tego część kart HDA gra, ale nie przełącza wyjść/wejść.
    #   • sof-firmware – firmware SOF/AVS dla nowszych Intel Audio DSP;
    #     linux-firmware (meta) nie zawiera go w swojej liście rozbić.
    pipewire wireplumber alsa-utils alsa-plugins alsa-ucm-conf
    sof-firmware pavucontrol rtkit
    # X + XFCE4 (domyślny manager okien: xfwm4 z meta-pakietu xfce4)
    # libglvnd = dyspozytor GL/EGL; vulkan-icd-loader = ładowanie sterowników
    # Vulkan (RADV/ANV z mesa, NVIDIA z nvidia-*). Dzięki temu GL i Vulkan
    # działają od razu, bez sięgania do grupy w instalatorze.
    xorg-server mesa libglvnd vulkan-icd-loader xfce4 lightdm lightdm-gtk-greeter
    # X: wejście (libinput + evdev + synaptics) i sterowniki wideo dla realnych
    # kart oraz maszyn wirtualnych (tryb modesetting daje sam xorg-server;
    # NVIDIA dostarczają nvidia-*). Dzięki temu touchpady, mysz/klawiatura
    # i akceleracja działają „od razu”, także w QEMU/VirtualBox/VMware.
    xorg-xf86-input-libinput xorg-xf86-input-evdev xorg-xf86-input-synaptics
    xorg-xf86-video-vesa xorg-xf86-video-ati xorg-xf86-video-amdgpu
    xorg-xf86-video-intel xorg-xf86-video-nouveau xorg-xf86-video-vmware
    xorg-xf86-video-qxl xorg-xf86-video-vboxvideo
    xorg-setxkbmap xorg-xrandr
    # drobiazgi pulpitu XFCE
    xdg-utils xfce4-screenshooter xfce4-clipman-plugin xfce4-taskmanager
    noto-fonts noto-fonts-emoji dejavu-ttf papirus-icon-theme
    # Flatpak WBUDOWANY DOMYŚLNIE – `pag flatpak <search|install|…>` ma działać
    # z pudełka. xdg-desktop-portal(-gtk) przychodzą jako zależności flatpaka,
    # a ścieżki eksportu (menu/PATH) ustawia /etc/profile.d z pakietu flatpak.
    flatpak
    # pag + pakiety wydania i branding Pagan
    # UWAGA: bez `pagan-wallpapers` – tapety to artefakt BRANDINGU silnika
    # (_phase_branding instaluje je do /usr/share/wallpapers/paganlinux),
    # a nie paczka z repo. Trzymanie jej tutaj wywalało weryfikację stacku.
    pag pagan-release pagan-welcome
    pagan-xfce-panel-layout pagan-xfce-look pagan-fixes
    # narzędzia info + branding/neofetch (paczki z repo)
    neofetch fastfetch
    # Instalator systemu: WŁASNY `pagan-install` (TUI) — Calamares USUNIĘTY.
    # Potrzebne narzędzia (reszta – sfdisk/blkid z util-linux, cryptsetup, grub,
    # efibootmgr, os-prober, dosfstools, squashfs-tools – jest wyżej):
    #   • dialog – interfejs TUI instalatora,
    #   • rsync  – kopiowanie systemu z /live/root na dysk,
    #   • kbd    – keymapy dla localectl/instalatora.
    dialog rsync kbd
    # powłoki: zsh (domyślna interaktywna) + bash-completion + jq dla pagan-ai
    zsh bash-completion jq
)
STACK_NVIDIA=(nvidia-dkms nvidia-kernel)

# ── Luna: Wayland (kompozytor Selene) + własny toolkit libLuna ───────────────
# Zamiast Xorg/XFCE/LightDM: greetd + luna-greeter-session + luna-session.
# `luna-desktop` to meta-pakiet (selene, luna, branding, greeter, pliki,
# multimedia, edytor, ustawienia, sklep, terminal, EQ, portale XDG).
STACK_LUNA=(
    # jądro + firmware + rozruch
    kernel linux-firmware grub os-prober efibootmgr busybox findutils
    dosfstools mtools squashfs-tools gptfdisk parted
    # fundament systemu + DKMS
    gcc make binutils pkgconf
    systemd dbus polkit shadow sudo util-linux kmod
    e2fsprogs xfsprogs btrfs-progs lvm2 cryptsetup mdadm
    tzdata ca-certificates nss nss-mdns
    # sieć
    networkmanager wpa-supplicant iw rfkill wireless-regdb dhcpcd iproute2
    # dźwięk
    pipewire wireplumber alsa-utils alsa-plugins alsa-ucm-conf
    sof-firmware pavucontrol rtkit
    # grafika: Wayland + Mesa/GL/Vulkan + Xwayland (dla aplikacji X11)
    mesa libglvnd vulkan-icd-loader xorg-xwayland
    xdg-utils shared-mime-info desktop-file-utils
    noto-fonts noto-fonts-emoji dejavu-ttf
    flatpak
    # pag + wydanie
    pag pagan-release
    # narzędzia instalatora + podstawowe narzędzia systemu
    # (zsh = domyślna powłoka interaktywna; bash zostaje dla skryptów i roota;
    #  bash-completion = dopełnianie w bashu; jq = parsowanie JSON w pagan-ai)
    dialog rsync kbd zsh bash-completion jq nano perl
    # Luna: środowisko + instalator + powitanie/sklep/ustawienia
    greetd luna-desktop luna-welcome luna-installer luna-store luna-settings
)

# Pakiety potrzebne, by w ogóle WYSTARTOWAĆ rootfs i uruchomić w nim pythona
# (czyli `pag`). To zarodek bootstrapu – ich zależności dociągnie resolver.
BOOTSTRAP_SEEDS=(
    glibc bash coreutils python gnupg pag
    ncurses readline pcre2 zlib bzip2 xz openssl expat libffi
    sed grep gawk tar gzip util-linux shadow ca-certificates
)

# ========================= CLI =========================
# Walidacja nazwy/wersji systemu. Nazwa trafia do os-release, GRUB-a i nazw
# artefaktów, więc odrzucamy znaki, które rozjechałyby quoting/ścieżki.
_validate_identity() {
    [[ "$PAGAN_NAME" =~ [^[:space:]] ]] || { echo "Nazwa systemu nie może być pusta." >&2; exit 1; }
    [[ "$PAGAN_VERSION" =~ [^[:space:]] ]] || { echo "Wersja systemu nie może być pusta." >&2; exit 1; }
    case "$PAGAN_NAME$PAGAN_VERSION" in
        */*|*\\*|*\"*|*\'*|*\**|*\?*|*\[*|*\]*|*\$*|*\`*|*$'\n'*|*$'\r'*)
            echo "Nazwa/wersja nie może zawierać znaków: / \\ \" ' * ? [ ] \$ \` ani nowej linii." >&2
            exit 1 ;;
    esac
    PAGAN_NAME="${PAGAN_NAME#"${PAGAN_NAME%%[![:space:]]*}"}"
    PAGAN_NAME="${PAGAN_NAME%"${PAGAN_NAME##*[![:space:]]}"}"
    PAGAN_VERSION="${PAGAN_VERSION#"${PAGAN_VERSION%%[![:space:]]*}"}"
    PAGAN_VERSION="${PAGAN_VERSION%"${PAGAN_VERSION##*[![:space:]]}"}"
    if [[ -z "$PAGAN_FILE_PREFIX" ]]; then
        PAGAN_FILE_PREFIX="${PAGAN_NAME// /-}"
    fi
    export PAGAN_NAME PAGAN_VERSION PAGAN_FILE_PREFIX
}

# ========================= MIEJSCE BUDOWY =========================
# rootfs + cache buildera potrafią zająć 25-35 GB. Domyślnie / (60 GB)
# zapychał się po dwóch buildach, a wtedy `pag install` dusił się na zapisie
# (objaw: pojedynczy pakiet „wisi” kilkadziesiąt minut). Dlatego przy braku
# --root wybieramy OSOBNĄ partycję z dużym zapasem – zwykle /home.
_free_kb() {
    local v
    v="$(df -Pk "$1" 2>/dev/null | awk 'NR==2 {print $4}')"
    printf '%s' "${v:-0}"
}
_mount_of() {
    df -P "$1" 2>/dev/null | awk 'NR==2 {print $6}'
}

# Bezpieczna nazwa katalogu: „Pagan Linux” -> „pagan-linux”.
_slug() {
    local s
    s="$(printf '%s' "$1" | iconv -f UTF-8 -t ASCII//TRANSLIT 2>/dev/null || printf '%s' "$1")"
    s="$(printf '%s' "$s" | tr '[:upper:]' '[:lower:]' \
        | sed -E 's/[^a-z0-9._-]+/-/g; s/^-+//; s/-+$//')"
    printf '%s' "${s:-pagan}"
}

_pick_build_location() {
    local base="" slug min_kb explicit=0
    min_kb=$(( ${PAGAN_MIN_FREE_GB:-30} * 1024 * 1024 ))

    if [[ -n "${PAGAN_ROOT:-}" ]]; then
        explicit=1   # jawnie podany (--root / PAGAN_ROOT) – nie zgadujemy
    elif [[ -n "${PAGAN_BUILD_DIR:-}" ]]; then
        base="${PAGAN_BUILD_DIR%/}"
    else
        # Katalog budowy nazwany od systemu: /home/<nazwa>, np. /home/luna.
        slug="$(_slug "$PAGAN_NAME")"
        # /home odciąża / tylko wtedy, gdy jest OSOBNYM systemem plików
        # i ma zapas na rootfs + cache + ISO.
        if [[ -d /home && "$(_mount_of /home)" != "/" ]] \
           && (( $(_free_kb /home) >= min_kb )); then
            base="/home/$slug"
        fi
    fi

    if (( explicit )); then
        # PAGAN_ROOT zostaje bez zmian; brakujące katalogi uzupełniamy domyślnymi.
        [[ -n "${OUTPUT_DIR:-}" ]] || OUTPUT_DIR="$SCRIPT_DIR/ISO"
    elif [[ -n "$base" ]]; then
        PAGAN_ROOT="$base/rootfs"
        [[ -n "${WORK_DIR:-}" ]] || WORK_DIR="$base/cache"
        [[ -n "${OUTPUT_DIR:-}" ]] || OUTPUT_DIR="$base/ISO"
    else
        PAGAN_ROOT="/mnt/pagan"      # zgodność z dotychczasowym domyślnym
        [[ -n "${OUTPUT_DIR:-}" ]] || OUTPUT_DIR="$SCRIPT_DIR/ISO"
    fi

    # Migracja: stary build używał /mnt/pagan. Gdy --reuse-rootfs wskazuje na
    # niego, a nowe miejsce jest puste – zostań przy starym (inaczej użytkownik
    # dostałby pełny bootstrap bez ostrzeżenia). Tylko dla roota AUTO – jawne
    # --root zawsze wygrywa.
    if (( ! explicit && SKIP_BOOTSTRAP )) && [[ ! -x "$PAGAN_ROOT/usr/bin/pag" && -x /mnt/pagan/usr/bin/pag ]]; then
        PAGAN_ROOT="/mnt/pagan"
        [[ -n "${WORK_DIR:-}" ]] || WORK_DIR="/var/cache/pagan-build"
    fi

    [[ -n "${WORK_DIR:-}" ]] || WORK_DIR="/var/cache/pagan-build"
    [[ -n "${OUTPUT_DIR:-}" ]] || OUTPUT_DIR="$SCRIPT_DIR/ISO"
    REPO_CACHE="$WORK_DIR/repo"
    BOOTSTRAP_CACHE="$WORK_DIR/bootstrap"
    export PAGAN_ROOT WORK_DIR OUTPUT_DIR

    if [[ -d /mnt/pagan && "$PAGAN_ROOT" != "/mnt/pagan" ]]; then
        BUILD_LOCATION_NOTE="stary rootfs /mnt/pagan nadal zajmuje miejsce – przenieś lub usuń"
    fi
}

# PAGAN_ROOT musi być dedykowanym podkatalogiem. Odmawiamy "/", "/dev",
# "/proc", "/sys", "/run" i ich poddrzew – inaczej _umount_vfs / rm -rf
# mogłyby zniszczyć hosta.
_validate_root() {
    [[ -n "${PAGAN_ROOT:-}" ]] || { echo "PAGAN_ROOT jest pusty." >&2; exit 1; }
    local rp="$PAGAN_ROOT"
    if command -v realpath >/dev/null 2>&1; then
        rp="$(realpath -m -- "$PAGAN_ROOT" 2>/dev/null || true)"
    fi
    [[ -n "$rp" ]] || { echo "Nie mogę rozwiązać PAGAN_ROOT='$PAGAN_ROOT'." >&2; exit 1; }
    [[ "$rp" == /?*/* ]] || {
        echo "PAGAN_ROOT musi być dedykowanym podkatalogiem (np. /mnt/pagan), nie '$PAGAN_ROOT'." >&2
        exit 1
    }
    case "$rp" in
        /|/dev|/dev/*|/proc|/proc/*|/sys|/sys/*|/run|/run/*|\
        /boot|/boot/*|/usr|/usr/*|/etc|/etc/*|/var|/var/*|\
        /bin|/bin/*|/sbin|/sbin/*|/lib|/lib/*|/lib64|/lib64/*|\
        /mnt|/media|/home|/root|/tmp)
            echo "Niebezpieczny PAGAN_ROOT='$PAGAN_ROOT' (rozwiązuje się do '$rp')." >&2
            echo "Wskaż dedykowany katalog, np. --root /mnt/pagan." >&2
            exit 1 ;;
    esac
    PAGAN_ROOT="$rp"
    export PAGAN_ROOT
}

# Plan budowy / wyjaśnienie GRUB-a, initramfs i jądra. Nie dotyka systemu,
# nie wymaga roota i nie tworzy katalogów – można uruchomić przed sudo.
pb_print_plan() {
    local nv="tak" pub="nie" tryb="budowa" de_desc="XFCE4 (Xorg)" inst_desc="instalator TUI (pagan-install)"
    if [[ "${PAGAN_DE,,}" == "luna" ]]; then
        de_desc="Luna (Selene/Wayland + libLuna)"
        inst_desc="luna-installer"
    fi
    if (( NO_NVIDIA )); then nv="pominięte (--no-nvidia)"; fi
    if (( PUBLISH )); then pub="tak → ${REMOTE:-BRAK --remote}"; fi
    if (( CHECK )); then tryb="--check (tylko weryfikacja)"; fi

    cat <<EOF
╔══════════════════════════════════════════════════════════════════════╗
║  Pagan Linux – builder v2: PLAN BUDOWY (bez wykonywania zmian)       ║
╚══════════════════════════════════════════════════════════════════════╝

  DE:          ${PAGAN_DE^^} – ${de_desc}
  nazwa:       ${PAGAN_NAME}
  wersja:      ${PAGAN_VERSION}
  artefakt:    ${ARTIFACT}
  repo:        ${PAGAN_REPO_URL}
  rootfs:      ${PAGAN_ROOT}
  cache:       ${WORK_DIR}
  ISO:         ${OUTPUT_DIR}
  NVIDIA:      ${nv}
  publikacja:  ${pub}
  tryb:        ${tryb}

  ETAPY (kolejność jak w main):
   1. Wymagania hosta – python3, wget, xorriso, mksquashfs, mtools, chroot…
   2. Indeks repo    – pobranie repo.json i policzenie pakietów.
   3. Szkielet rootfs – katalogi w ${PAGAN_ROOT} (pomijany z --reuse-rootfs).
   4. Bootstrap      – rozpakowanie glibc/bash/python/pag + zależności.
   5. Stack z repo   – jądro, systemd, sieć, dźwięk, ${de_desc}, GRUB, NVIDIA
                       (każdy pakiet przez \`pag install\`).
   6. Konfiguracja   – usługi systemd, locale, /etc/default/grub, NVIDIA KMS,
                       initramfs dla jądra z repo.
   7. Branding       – tapety, logo LOKI, neofetch, splash GRUB, pagan-wifi.
   8. Pliki wydania  – os-release, pagan-release, rejestracja rolling.
   9. Pakowanie      – finalize_build, pagan-initramfs, initramfs LIVE,
                       ${inst_desc}, ISO i/lub IMG.
  10. Publikacja    – opcjonalny rsync paczek wydania (--publish --remote).

  DŹWIĘK I GRAFIKA – co trafia do obrazu i kiedy startuje:
    • jądro \`kernel\` + \`linux-firmware\` (meta: amdgpu/i915/nouveau/… firmware)
      + \`sof-firmware\` + \`alsa-ucm-conf\` – moduły snd_* i profile UCM;
    • PipeWire + WirePlumber + pipewire-pulse + ALSA (alsa-utils/plug-ins)
      + xfce4-pulseaudio-plugin (wchodzi z meta-pakietem xfce4);
    • usługi: \`systemctl --global enable\` pipewire/wireplumber/pipewire-pulse
      oraz \`rtkit-daemon\`; w live (root) dodatkowo autostart
      /etc/xdg/autostart/pagan-audio.desktop → pagan-audio-setup;
    • grafika: KMS (i915/amdgpu/nouveau/nvidia-drm), Mesa + libglvnd +
      Vulkan ICD, Xorg modesetting + xf86-video-*;
    • NVIDIA: nvidia-dkms (userspace + Xorg/udev) + nvidia-kernel (moduły);
    • autostart pagan-display-setup → xrandr --auto / nvidia-settings.

  JĄDRO (kernel) – v2 NIE kompiluje jądra:
    • pakiet \`kernel\` (provides: linux) jest instalowany z repo przez pag;
    • po \`pag upgrade\` nowe jądro uruchamia hook post-install pakietu:
      dkms autoinstall (NVIDIA/VirtualBox) → pagan-initramfs → aliasy
      /boot/initramfs-<wersja>.img → pag grub-update (jeśli brak locka pag);
    • dlatego w obrazie musi być /usr/bin/pagan-initramfs. v2 instaluje go
      w fazie pakowania (install_initramfs_tool).

  GRUB – gdzie naprawdę leci grub-install:
    • ISO: NIE ma grub-install. create_iso buduje menu: ISOLINUX dla BIOS
      + grub-mkstandalone dla UEFI (EFI/BOOT/BOOTX64.EFI).
    • IMG: create_image robi grub-install --target=i386-pc ORAZ
      --target=x86_64-efi wewnątrz chroot obrazu (MBR + ESP).
    • Instalacja na dysk: robi to pagan-install (TUI) w chrootcie celu:
      grub-install (UEFI/BIOS) + grub-mkconfig → /boot/grub/grub.cfg.
    • Po aktualizacji jądra wpisy odświeża pag grub-update / hook kernel.

  INITRAMFS – dwa różne obrazy:
    • initramfs systemu: pagan-initramfs (per wersja jądra, aliasy dla GRUB);
      bez niego fallback to initrd skopiowany z pakietu (best-effort);
    • initramfs LIVE: build_initramfs (busybox+cpio) obsługujący squashfs,
      root=UUID i LUKS; zapisuje /boot/initramfs.img i aliasy wersji.
    • Instalator uruchamia pagan-initramfs w chrootcie celu; jeśli padnie,
      zostaje initramfs z live (umie wykryć root).

  Uruchom bez --plan, aby wykonać powyższe. Kreator: --wizard.
EOF
}

_usage() {
    # Nagłówek pliku to dokumentacja – wypisz go aż do linii z `set -Eeuo`.
    awk 'NR > 1 && /^set -Eeuo pipefail/ { exit } NR > 1 { print }' "$0"
    exit "${1:-0}"
}
ARGC=$#
while [[ $# -gt 0 ]]; do
    case "$1" in
        xfce|luna|deepin|budgie|pagande|kartonde|none|server) PAGAN_DE="$1"; shift ;;
        iso|img|both) ARTIFACT="$1"; shift ;;
        --repo)      PAGAN_REPO_URL="${2%/}"; shift 2 ;;
        --de)        PAGAN_DE="$2"; shift 2 ;;
        --de=*)      PAGAN_DE="${1#*=}"; shift ;;
        --root)      PAGAN_ROOT="$2"; shift 2 ;;
        --work-dir)  WORK_DIR="$2"; shift 2 ;;
        --work-dir=*) WORK_DIR="${1#*=}"; shift ;;
        --name)      PAGAN_NAME="$2"; PAGAN_NAME_EXPLICIT=1; shift 2 ;;
        --name=*)    PAGAN_NAME="${1#*=}"; PAGAN_NAME_EXPLICIT=1; shift ;;
        --version)   PAGAN_VERSION="$2"; shift 2 ;;
        --snapshot)  export PAGAN_SNAPSHOT="$2"; shift 2 ;;
        --jobs)      export PAGAN_JOBS="$2"; shift 2 ;;
        --rebuild)   REBUILD=1; shift ;;
        --reuse-rootfs) SKIP_BOOTSTRAP=1; shift ;;
        --no-nvidia) NO_NVIDIA=1; shift ;;
        --check)     CHECK=1; shift ;;
        --publish)   PUBLISH=1; shift ;;
        --remote)    REMOTE="${2:-}"; shift 2 ;;
        --remote=*)  REMOTE="${1#*=}"; shift ;;
        -i|--interactive|--wizard) INTERACTIVE=1; shift ;;
        -y|--yes|--non-interactive|--assume-yes) NONINTERACTIVE=1; shift ;;
        -q|--quiet)  QUIET=1; shift ;;
        -v|--verbose) VERBOSE=1; shift ;;
        --no-anim|--no-animation) PB_ANIM=0; shift ;;
        --plan|--dry-run) SHOW_PLAN=1; shift ;;
        --no-initramfs-tool) NO_INITRAMFS_TOOL=1; shift ;;
        -h|--help)   _usage ;;
        *) echo "Nieznany argument: $1" >&2; _usage 2 ;;
    esac
done

[[ "$ARTIFACT" =~ ^(iso|img|both)$ ]] || { echo "Artefakt: iso|img|both" >&2; exit 1; }
case "${PAGAN_DE,,}" in
    xfce|luna|deepin|budgie|pagande|kartonde|none|server) ;;
    *) echo "Nieznane DE: $PAGAN_DE (obsługiwane: xfce, luna)" >&2; exit 1 ;;
esac
# Ten silnik dźwiga DE meta-pakietami z repo; obsłużone są XFCE4 i Luna.
if [[ "${PAGAN_DE,,}" != "xfce" && "${PAGAN_DE,,}" != "luna" ]]; then
    echo "UWAGA: silnik v2 obsługuje XFCE4 i Lunę." >&2
    echo "       DE='$PAGAN_DE' nie jest tu jeszcze obsłużone – kontynuuję jako xfce." >&2
    PAGAN_DE="xfce"
fi

# Domyślna nazwa wydania Luny – żeby nie kolidowała z buildem XFCE w /home.
if [[ "${PAGAN_DE,,}" == "luna" && "$PAGAN_NAME_EXPLICIT" -eq 0 ]]; then
    PAGAN_NAME="Pagan Linux Luna"
fi

# Miejsce budowy zależy od nazwy systemu → wybieramy PO ustaleniu DE/nazwy.
_pick_build_location
[[ -n "$PAGAN_ROOT" && "$PAGAN_ROOT" != "/" ]] || { echo "Niebezpieczny PAGAN_ROOT='$PAGAN_ROOT'" >&2; exit 1; }

# --plan nie wymaga roota i nie tworzy katalogów w /var.
_validate_identity
if (( SHOW_PLAN )); then
    pb_print_plan
    exit 0
fi

[[ $EUID -eq 0 ]] || { echo "Uruchom jako root (sudo)." >&2; exit 1; }

mkdir -p "$WORK_DIR" "$REPO_CACHE" "$BOOTSTRAP_CACHE" "$OUTPUT_DIR" "$(dirname "$LOG_FILE")"
: > "$LOG_FILE"

# ========================= LOGOWANIE =========================
C_G=$'\033[0;32m'; C_Y=$'\033[1;33m'; C_R=$'\033[0;31m'; C_B=$'\033[0;34m'; C_D=$'\033[2m'; C_0=$'\033[0m'
_log() { printf '%s\n' "$*" | tee -a "$LOG_FILE" >&2; }
step() { _log ""; _log "${C_B}▶ $*${C_0}"; }
ok()   { _log "  ${C_G}✓${C_0} $*"; }
warn() { _log "  ${C_Y}!${C_0} $*"; }
die()  { _log "  ${C_R}✗ BŁĄD:${C_0} $*"; exit 1; }
_have() { command -v "$1" >/dev/null 2>&1; }

# ========================= BEZPIECZEŃSTWO PAGAN_ROOT =========================
# _umount_vfs dotyka dev/proc/sys/run POD PAGAN_ROOT. Przy złym rootcie
# (np. "/", "//", "/." albo symlink do "/") odmontowałoby to HOSTA.
# Dlatego każdy root jest rozwiązywany przez realpath i twardo odrzucany,
# jeśli wskazuje system krytyczny.
_safe_pagan_root() {
    [[ -n "${PAGAN_ROOT:-}" ]] || return 1
    local rp="$PAGAN_ROOT"
    if command -v realpath >/dev/null 2>&1; then
        rp="$(realpath -m -- "$PAGAN_ROOT" 2>/dev/null || true)"
    fi
    [[ -n "$rp" && "$rp" != "/" ]] || return 1
    case "$rp" in
        /dev|/dev/*|/proc|/proc/*|/sys|/sys/*|/run|/run/*|\
        /boot|/boot/*|/usr|/usr/*|/etc|/etc/*|/var|/var/*|\
        /bin|/bin/*|/sbin|/sbin/*|/lib|/lib/*|/lib64|/lib64/*|\
        /mnt|/media|/home|/root|/tmp) return 1 ;;
    esac
    printf '%s' "$rp"
}

# Sprzątanie montowań przy wyjściu
_VFS_MOUNTED=0
# Zwraca ścieżkę celu TYLKO jeśli po rozwiązaniu symlinków nadal leży
# pod $rp. Bez tego `dev` będący symlinkiem do /dev sprawiał, że
# `umount -R "$rp/dev"` zdejmował HOSTA (znikające /dev/null, /dev/pts).
_vfs_target() {
    local rp="$1" rel="$2" t
    t="$(realpath -m -- "$rp/$rel" 2>/dev/null || true)"
    [[ -n "$t" && "$t" == "$rp"/* ]] || return 1
    printf '%s' "$t"
}

_umount_vfs() {
    local rp m t
    rp="$(_safe_pagan_root)" || return 0
    for m in dev/pts dev proc sys run; do
        t="$(_vfs_target "$rp" "$m")" || continue
        mountpoint -q "$t" 2>/dev/null && umount -R -- "$t" 2>/dev/null || true
    done
    _VFS_MOUNTED=0
}
trap '_pb_cleanup' EXIT INT TERM

# ========================= UI: POSTĘP / ANIMACJE / KREATOR =========================
# Zasady:
#   • animacje tylko na terminalu (stderr TTY) – log i CI zostają czyste;
#   • każda długa komenda idzie do $LOG_FILE, na konsoli widać spinner + czas;
#   • --verbose pokazuje pełny log komend, --quiet ogranicza komunikaty;
#   • kreator używa whiptail/dialog, a bez nich prostych pytań w terminalu.
PB_QUIET="${QUIET:-0}"
PB_VERBOSE="${VERBOSE:-0}"
PB_TTY=0
if [[ -t 2 && "$PB_ANIM" != "0" ]]; then PB_TTY=1; fi
PB_START=${SECONDS}
PB_SPIN_PID=""
PB_SPIN_MSG=""
PB_SPIN_T0=0
PB_PHASE_N=0
PB_PHASE_TOTAL=0
PB_PHASE_T0=""
PB_UI_RESULT=""

# UTF-8 daje ładne znaki; w C/POSIX zostają ASCII (czytelne w każdym logu).
case "${LC_ALL:-${LC_CTYPE:-${LANG:-}}}" in
    *UTF-8*|*utf8*|*UTF8*|*utf-8*) PB_SPIN_FRAMES=( '⠋' '⠙' '⠹' '⠸' '⠼' '⠴' '⠦' '⠧' '⠇' '⠏' ) ;;
    *)                            PB_SPIN_FRAMES=( '|' '/' '-' '\' ) ;;
esac

pb_fmt_time() {
    local s="${1:-0}"
    if (( s >= 3600 )); then
        printf '%dh %02dm %02ds' $(( s / 3600 )) $(( (s % 3600) / 60 )) $(( s % 60 ))
    elif (( s >= 60 )); then
        printf '%dm %02ds' $(( s / 60 )) $(( s % 60 ))
    else
        printf '%ds' "$s"
    fi
}

pb_elapsed() { pb_fmt_time $(( SECONDS - PB_START )); }
pb_clear()   { if (( PB_TTY )); then printf '\r\033[2K' >&2; fi; }

# Postęp pokazujemy jako [n/total] w etykiecie spinnera – animacja i licznik
# są w jednej linii, bez migotania i bez zaśmiecania logu.
# Spinner w tle – tylko terminal. Zatrzymanie zawsze czyści linię.
pb_spin_start() {
    PB_SPIN_MSG="${1:-}"
    PB_SPIN_T0=$SECONDS
    if (( ! PB_TTY )); then
        (( PB_QUIET )) || _log "  … $PB_SPIN_MSG"
        return 0
    fi
    pb_spin_stop
    (
        local i=0
        while :; do
            local t=$(( SECONDS - PB_SPIN_T0 ))
            printf '\r\033[2K  %s %s  \033[2m[%s]\033[0m' \
                "${PB_SPIN_FRAMES[i]}" "$PB_SPIN_MSG" "$(pb_fmt_time "$t")" >&2
            i=$(( (i + 1) % ${#PB_SPIN_FRAMES[@]} ))
            sleep 0.12
        done
    ) &
    PB_SPIN_PID=$!
}

pb_spin_stop() {
    if [[ -n "${PB_SPIN_PID:-}" ]]; then
        kill "$PB_SPIN_PID" 2>/dev/null || true
        wait "$PB_SPIN_PID" 2>/dev/null || true
        PB_SPIN_PID=""
    fi
    pb_clear
}

# Ostatnie linie logu – przy błędzie długiej komendy, bez zaśmiecania logu.
pb_tail() {
    local n="${1:-8}"
    [[ -s "$LOG_FILE" ]] || return 0
    tail -n "$n" "$LOG_FILE" | sed 's/^/      /' >&2 || true
}

# Uruchamia komendę: spinner (TTY) albo linia w logu; stdout/stderr do logu.
pb_run() {
    local label="$1"; shift
    local rc=0
    if (( PB_QUIET )); then
        "$@" >>"$LOG_FILE" 2>&1 || rc=$?
        return "$rc"
    fi
    if (( PB_VERBOSE )); then
        _log "  … $label"
        # >&2: UI zostaje na stderr, więc command substitution (np. ścieżka
        # pakietu z _fetch_pag) nigdy nie złapie logu komendy.
        "$@" 2>&1 | tee -a "$LOG_FILE" >&2
        rc=${PIPESTATUS[0]}
        return "$rc"
    fi
    if (( PB_TTY )); then
        pb_spin_start "$label"
        "$@" >>"$LOG_FILE" 2>&1 || rc=$?
        pb_spin_stop
    else
        _log "  … $label"
        "$@" >>"$LOG_FILE" 2>&1 || rc=$?
    fi
    return "$rc"
}

# pb_run + ✓/✗ z czasem; przy błędzie pokazuje ogon logu.
pb_run_ok() {
    local label="$1"; shift
    local t0=$SECONDS rc=0
    pb_run "$label" "$@" || rc=$?
    local dt=$(( SECONDS - t0 ))
    if (( rc == 0 )); then
        ok "$label ($(pb_fmt_time "$dt"))"
    else
        warn "$label – BŁĄD (kod $rc, $(pb_fmt_time "$dt"))"
        pb_tail 8
    fi
    return "$rc"
}

# Nagłówek etapu [n/total] + czas poprzedniego etapu.
pb_phase() {
    local title="$1" desc="${2:-}"
    PB_PHASE_N=$(( PB_PHASE_N + 1 ))
    pb_spin_stop
    _log ""
    if [[ -n "${PB_PHASE_T0:-}" ]]; then
        _log "   ${C_D:-}✓ poprzedni etap: $(pb_fmt_time $(( SECONDS - PB_PHASE_T0 )))${C_0}"
    fi
    local tag=""
    if (( PB_PHASE_TOTAL > 0 )); then tag="[${PB_PHASE_N}/${PB_PHASE_TOTAL}] "; fi
    _log "${C_B}▶ ${tag}${title}${C_0}"
    [[ -n "$desc" ]] && _log "   ${C_D:-}${desc}${C_0}"
    PB_PHASE_T0=$SECONDS
    return 0
}

_pb_cleanup() {
    if declare -F pb_spin_stop >/dev/null 2>&1; then pb_spin_stop 2>/dev/null || true; fi
    # Funkcje starego buildera istnieją dopiero po source — sprawdzamy w runtime.
    if declare -F _cleanup_image_mounts >/dev/null 2>&1; then
        _cleanup_image_mounts 2>/dev/null || true
    fi
    if declare -F umount_virtual_fs >/dev/null 2>&1; then
        umount_virtual_fs 2>/dev/null || true
    fi
    _umount_vfs 2>/dev/null || true
}

# ── Kreator: whiptail/dialog, z fallbackiem na zwykłe pytania ────────────────
PB_DIALOG=""
if command -v whiptail >/dev/null 2>&1; then PB_DIALOG="whiptail"
elif command -v dialog >/dev/null 2>&1; then PB_DIALOG="dialog"; fi

pb_ui_msg() {
    local title="$1" text="$2"
    if [[ -n "$PB_DIALOG" ]]; then
        "$PB_DIALOG" --title "$title" --msgbox "$text" 22 78 3>&1 1>&2 2>&3 || true
    else
        printf '\n\033[1m== %s ==\033[0m\n%s\n\n' "$title" "$text" >&2
        printf 'Enter, aby kontynuować… ' >&2
        read -r _ || true
    fi
}

pb_ui_yesno() {
    local title="$1" text="$2" def="${3:-yes}"
    if [[ -n "$PB_DIALOG" ]]; then
        if [[ "$def" == "yes" ]]; then
            "$PB_DIALOG" --title "$title" --yesno "$text" 12 78
        else
            "$PB_DIALOG" --title "$title" --defaultno --yesno "$text" 12 78
        fi
        return $?
    fi
    local ans
    if [[ "$def" == "yes" ]]; then
        printf '%s [T/n]: ' "$text" >&2
    else
        printf '%s [t/N]: ' "$text" >&2
    fi
    read -r ans || true
    ans="${ans:-$def}"
    [[ "${ans,,}" == t* || "${ans,,}" == y* ]]
}

pb_ui_input() {
    local title="$1" text="$2" def="${3:-}"
    PB_UI_RESULT=""
    if [[ -n "$PB_DIALOG" ]]; then
        PB_UI_RESULT="$("$PB_DIALOG" --title "$title" --inputbox "$text" 10 78 "$def" 3>&1 1>&2 2>&3)" || return 1
    else
        printf '%s [%s]: ' "$text" "$def" >&2
        read -r PB_UI_RESULT || true
        PB_UI_RESULT="${PB_UI_RESULT:-$def}"
    fi
    PB_UI_RESULT="${PB_UI_RESULT//$'\n'/ }"
    return 0
}

# pb_ui_radiolist TYTUŁ OPIS DOMYŚLNY tag opis [tag opis …]
pb_ui_radiolist() {
    local title="$1" text="$2" def="$3"; shift 3
    PB_UI_RESULT=""
    local -a items=() args=()
    local tag item
    while (( $# >= 2 )); do
        tag="$1"; item="$2"; shift 2
        items+=( "$tag|$item" )
        if [[ "$tag" == "$def" ]]; then args+=( "$tag" "$item" "on" )
        else                            args+=( "$tag" "$item" "off" ); fi
    done
    if [[ -n "$PB_DIALOG" ]]; then
        PB_UI_RESULT="$("$PB_DIALOG" --title "$title" --radiolist "$text" 20 78 10 "${args[@]}" 3>&1 1>&2 2>&3)" || return 1
        PB_UI_RESULT="${PB_UI_RESULT//\"/}"; PB_UI_RESULT="${PB_UI_RESULT// /}"; PB_UI_RESULT="${PB_UI_RESULT//$'\n'/}"
        return 0
    fi
    printf '\n\033[1m== %s ==\033[0m\n%s\n' "$title" "$text" >&2
    local i=1 x
    for x in "${items[@]}"; do
        printf '  %d) %s\n' "$i" "${x#*|}" >&2
        i=$(( i + 1 ))
    done
    local ans
    while :; do
        printf 'Wybór [1-%d, domyślnie %s]: ' "${#items[@]}" "$def" >&2
        read -r ans || true
        ans="${ans:-$def}"
        if [[ "$ans" =~ ^[0-9]+$ ]]; then
            if (( ans >= 1 && ans <= ${#items[@]} )); then
                PB_UI_RESULT="${items[ans-1]%%|*}"; return 0
            fi
        else
            for x in "${items[@]}"; do
                [[ "$ans" == "${x%%|*}" ]] && { PB_UI_RESULT="$ans"; return 0; }
            done
        fi
        printf 'Nieprawidłowy wybór.\n' >&2
    done
}

# pb_ui_checklist TYTUŁ OPIS tag opis on|off [tag opis on|off …]
pb_ui_checklist() {
    local title="$1" text="$2"; shift 2
    PB_UI_RESULT=""
    local -a items=() args=()
    local tag item status
    while (( $# >= 3 )); do
        tag="$1"; item="$2"; status="$3"; shift 3
        items+=( "$tag|$item|$status" )
        args+=( "$tag" "$item" "$status" )
    done
    if [[ -n "$PB_DIALOG" ]]; then
        PB_UI_RESULT="$("$PB_DIALOG" --title "$title" --checklist "$text" 20 78 10 "${args[@]}" 3>&1 1>&2 2>&3)" || return 1
        PB_UI_RESULT="${PB_UI_RESULT//\"/}"; PB_UI_RESULT="${PB_UI_RESULT//$'\n'/ }"
        return 0
    fi
    printf '\n\033[1m== %s ==\033[0m\n%s\n' "$title" "$text" >&2
    local i=1 x
    for x in "${items[@]}"; do
        local st="nie" desc="${x#*|}"
        desc="${desc%|*}"
        [[ "${x##*|}" == "on" ]] && st="TAK"
        printf '  %d) %s [%s]\n' "$i" "$desc" "$st" >&2
        i=$(( i + 1 ))
    done
    printf 'Numery do włączenia (np. 1 3), Enter = bez zmian: ' >&2
    local ans
    read -r ans || true
    if [[ -n "$ans" ]]; then
        local t
        for t in $ans; do
            [[ "$t" =~ ^[0-9]+$ ]] || continue
            if (( t >= 1 && t <= ${#items[@]} )); then
                local chosen="${items[t-1]}"
                PB_UI_RESULT+="${chosen%%|*} "
            fi
        done
    else
        for x in "${items[@]}"; do
            [[ "${x##*|}" == "on" ]] && PB_UI_RESULT+="${x%%|*} "
        done
    fi
    return 0
}

pb_wizard() {
    if (( ! PB_TTY )); then
        warn "Kreator wymaga terminala – używam wartości z CLI."
        return 0
    fi
    pb_ui_msg "Pagan Linux – builder v2" "Builder stawia system WPROST z repo PAG.

W kreatorze wybierzesz:
  • nazwę i wersję systemu,
  • artefakt (ISO / IMG / oba),
  • sterowniki NVIDIA,
  • tryb rootfs (kontynuuj / od zera / reuse),
  • publikację i poziom logowania.

Dalej zobaczysz podsumowanie i potwierdzenie startu."

    pb_ui_radiolist "Artefakt" "Co zbudować?" "$ARTIFACT" \
        iso  "ISO live (BIOS+UEFI, instalator TUI)" \
        img  "IMG (dysk wirtualny, BIOS+UEFI)" \
        both "ISO + IMG" \
        || { warn "Anulowano kreator."; exit 130; }
    ARTIFACT="$PB_UI_RESULT"

    pb_ui_input "Nazwa systemu" "Podaj nazwę systemu (np. Pagan Linux):" "$PAGAN_NAME" \
        || { warn "Anulowano kreator."; exit 130; }
    PAGAN_NAME="$PB_UI_RESULT"

    pb_ui_input "Wersja systemu" "Podaj wersję (np. 1.0.0 Rolling):" "$PAGAN_VERSION" \
        || { warn "Anulowano kreator."; exit 130; }
    PAGAN_VERSION="$PB_UI_RESULT"
    _validate_identity

    local nv_def="yes"
    if (( NO_NVIDIA )); then nv_def="no"; fi
    if pb_ui_yesno "NVIDIA" "Dołączyć nvidia-dkms + nvidia-kernel?" "$nv_def"; then
        NO_NVIDIA=0
    else
        NO_NVIDIA=1
    fi

    local root_def="keep"
    if (( REBUILD )); then root_def="rebuild"
    elif (( SKIP_BOOTSTRAP )); then root_def="reuse"; fi
    pb_ui_radiolist "Rootfs" "Co zrobić z ${PAGAN_ROOT}?" "$root_def" \
        keep    "Kontynuuj / dokończ istniejący rootfs (bez czyszczenia)" \
        rebuild "Przebuduj od zera (--rebuild, czyści rootfs)" \
        reuse   "Użyj istniejącego rootfs, pomiń bootstrap (--reuse-rootfs)" \
        || { warn "Anulowano kreator."; exit 130; }
    case "$PB_UI_RESULT" in
        rebuild) REBUILD=1; SKIP_BOOTSTRAP=0 ;;
        reuse)   REBUILD=0; SKIP_BOOTSTRAP=1 ;;
        *)       REBUILD=0; SKIP_BOOTSTRAP=0 ;;
    esac

    local pub_st="off" verb_st="off" anim_st="off"
    if (( PUBLISH )); then pub_st="on"; fi
    if (( PB_VERBOSE )); then verb_st="on"; fi
    if (( PB_ANIM )); then anim_st="on"; fi
    pb_ui_checklist "Opcje" "Zaznacz dodatkowe opcje:" \
        publish "Publikuj paczki wydania do repo (rsync)" "$pub_st" \
        verbose "Pełny log komend na konsoli" "$verb_st" \
        anim    "Animacje / spinner w terminalu" "$anim_st" \
        || { warn "Anulowano kreator."; exit 130; }
    local sel=" $PB_UI_RESULT "
    if [[ "$sel" == *" publish "* ]]; then PUBLISH=1; else PUBLISH=0; fi
    if [[ "$sel" == *" verbose "* ]]; then PB_VERBOSE=1; else PB_VERBOSE=0; fi
    if [[ "$sel" == *" anim "* ]]; then PB_ANIM=1; else PB_ANIM=0; fi
    PB_TTY=0; if [[ -t 2 && "$PB_ANIM" != "0" ]]; then PB_TTY=1; fi

    if (( PUBLISH )); then
        pb_ui_input "Publikacja" "Cel rsync (user@host:/ścieżka/repo):" "$REMOTE" \
            || { warn "Anulowano kreator."; exit 130; }
        REMOTE="$PB_UI_RESULT"
    fi

    local nv="tak" pub="nie" rootmode="kontynuuj"
    if (( NO_NVIDIA )); then nv="nie"; fi
    if (( PUBLISH )); then pub="tak → ${REMOTE:-?}"; fi
    if (( REBUILD )); then rootmode="od zera (--rebuild)"; fi
    if (( SKIP_BOOTSTRAP )); then rootmode="reuse (--reuse-rootfs)"; fi

    pb_ui_msg "Podsumowanie" "artefakt:    ${ARTIFACT}
nazwa:       ${PAGAN_NAME}
wersja:      ${PAGAN_VERSION}
DE:          ${PAGAN_DE^^}
NVIDIA:      ${nv}
rootfs:      ${PAGAN_ROOT}
tryb rootfs: ${rootmode}
publikacja:  ${pub}
verbose:     $([[ $PB_VERBOSE == 1 ]] && echo tak || echo nie)
animacje:    $([[ $PB_ANIM == 1 ]] && echo tak || echo nie)"

    pb_ui_yesno "Start budowy" "Rozpocząć budowę z powyższymi ustawieniami?" yes \
        || { warn "Budowa anulowana przez użytkownika."; exit 130; }
}

# Kreator sam startuje, gdy nie podano żadnego argumentu i jesteśmy na TTY.
# Skrypty/CI (brak TTY) zachowują stare, nieinteraktywne zachowanie.
if (( INTERACTIVE )) || { (( ARGC == 0 && ! NONINTERACTIVE )) && [[ -t 0 && -t 2 ]]; }; then
    _log "Tryb interaktywny: kreator (pomiń: --non-interactive)"
    pb_wizard
fi

# ========================= POMOCNIK PYTHON =========================
# Jeden mały skrypt obsługuje: resolver zależności z repo.json i rozpakowanie
# .pag (outer tar.xz → data.tar.xz → rootfs). Dzięki temu bash jest czytelny.
PY_HELPER=""
_make_py_helper() {
    PY_HELPER="$WORK_DIR/pagan-build-helper.py"
    cat > "$PY_HELPER" <<'PYEOF'
#!/usr/bin/env python3
import sys, os, io, json, tarfile

def load_index(path):
    idx = json.load(open(path))
    pkgs, provides = {}, {}
    for p in idx.get("packages", []):
        n = p.get("name")
        if not n:
            continue
        pkgs[n] = p
        for pr in (p.get("provides") or []):
            provides.setdefault(pr, n)
    return pkgs, provides

def resolve(path, seeds):
    pkgs, provides = load_index(path)
    order, seen, missing, q = [], set(), [], list(seeds)
    while q:
        n = q.pop(0)
        real = n if n in pkgs else provides.get(n)
        if not real:
            missing.append(n); continue
        if real in seen:
            continue
        seen.add(real)
        q.extend(pkgs[real].get("depends") or [])
        order.append(real)
    for n in order:
        print(n)
    for m in missing:
        print("MISSING:" + m, file=sys.stderr)

def extract(pagfile, dest):
    def filt(member, _dest):
        if os.path.isabs(member.name) or ".." in member.name.split("/"):
            return None
        if member.name.endswith("sums.json") and member.isfile():
            return None
        return member
    with tarfile.open(pagfile, "r:xz") as tf:
        data = None
        try:
            data = tf.extractfile("data.tar.xz")
        except KeyError:
            data = None
        if data is None:
            print("brak data.tar.xz w %s" % pagfile, file=sys.stderr)
            return 2
        buf = io.BytesIO(data.read())
        with tarfile.open(fileobj=buf, mode="r:xz") as dt:
            try:
                dt.extractall(dest, filter=filt)
            except TypeError:
                dt.extractall(dest)
    return 0

def field(path, name, fld):
    pkgs, provides = load_index(path)
    p = pkgs.get(name) or (pkgs.get(provides[name]) if name in provides else None)
    if not p:
        return 1
    v = p.get(fld, "")
    print(" ".join(v) if isinstance(v, list) else v)

if __name__ == "__main__":
    cmd = sys.argv[1]
    if cmd == "resolve":
        resolve(sys.argv[2], sys.argv[3:])
    elif cmd == "extract":
        sys.exit(extract(sys.argv[2], sys.argv[3]))
    elif cmd == "field":
        sys.exit(field(sys.argv[2], sys.argv[3], sys.argv[4]) or 0)
    else:
        sys.stderr.write("nieznana komenda: %s\n" % cmd); sys.exit(2)
PYEOF
}

# ========================= HOST: WYMAGANIA =========================
_phase_host_deps() {
    pb_phase "WYMAGANIA HOSTA" "python3, wget, sha256sum, xorriso, mksquashfs, mkfs.vfat, mcopy, chroot, losetup"
    local missing=() c
    for c in python3 wget sha256sum xorriso mksquashfs mkfs.vfat mcopy chroot mount losetup; do
        _have "$c" || missing+=("$c")
    done
    if ((${#missing[@]})); then
        warn "Brakuje narzędzi: ${missing[*]}"
        _log "  Zainstaluj (Debian/Ubuntu): apt install python3 wget xorriso squashfs-tools mtools dosfstools e2fsprogs"
        _log "  Zainstaluj (Arch):          pacman -S python wget libisoburn squashfs-tools mtools dosfstools e2fsprogs"
        die "Uzupełnij narzędzia na hoście i uruchom ponownie."
    fi
    _make_py_helper
}

# ========================= TRYB --check (bez budowy) =========================
_phase_check() {
    pb_phase "CHECK – WERYFIKACJA PACZEK" "domknięcie zależności bootstrapu + każda nazwa pakietu stacku"
    local rc=0 n missing

    # 1) Bootstrap: policz domknięcie zależności i brakujące zarodki.
    mapfile -t _bs < <(python3 "$PY_HELPER" resolve "$INDEX_JSON" "${BOOTSTRAP_SEEDS[@]}" 2>"$WORK_DIR/chk-bs.err" || true)
    ok "bootstrap: ${#_bs[@]} pakietów w domknięciu zależności"
    if [[ -s "$WORK_DIR/chk-bs.err" ]]; then
        grep -o 'MISSING:[^ ]*' "$WORK_DIR/chk-bs.err" | sed 's/MISSING:/   - brak w repo: /' | tee -a "$LOG_FILE" >&2 || true
        rc=1
    fi

    # 2) Stack: każda nazwa musi istnieć w indeksie (wychwytuje literówki).
    local stack=("${STACK_BASE[@]}")
    (( NO_NVIDIA )) || stack+=("${STACK_NVIDIA[@]}")
    local p
    for p in "${stack[@]}"; do
        if [[ -z "$(python3 "$PY_HELPER" field "$INDEX_JSON" "$p" filename 2>/dev/null || true)" ]]; then
            warn "brak w repo: $p"
            rc=1
        fi
    done
    [[ $rc -eq 0 ]] && ok "wszystkie paczki stacku (${#stack[@]}) istnieją w repo" || true
    return $rc
}

# ========================= REPO: INDEKS =========================
INDEX_JSON="$REPO_CACHE/repo.json"
_phase_index() {
    pb_phase "INDEKS REPO PAG" "pobieram repo.json z ${PAGAN_REPO_URL} i liczę pakiety"
    local url="${PAGAN_REPO_URL%/}/repo.json"
    if ! pb_run "pobieranie repo.json" wget -q \
            --tries=5 --timeout=30 --waitretry=2 --retry-connrefused \
            -O "$INDEX_JSON.tmp" "$url"; then
        rm -f "$INDEX_JSON.tmp"
        die "Nie mogę pobrać $url (sieć? adres repo?)"
    fi
    mv -f "$INDEX_JSON.tmp" "$INDEX_JSON"
    local count
    count="$(python3 - "$INDEX_JSON" <<'PY'
import json,sys
print(len(json.load(open(sys.argv[1])).get("packages",[])))
PY
)"
    ok "repo.json: $count pakietów"
    (($count > 100)) || die "Podejrzanie mało pakietów w indeksie – przerywam."
    # Katalog z pobranymi .pag
    PKG_CACHE="$REPO_CACHE/pkgs"
    mkdir -p "$PKG_CACHE"
}

# Sprawdza, czy plik .pag jest kompletny (rozmiar + SHA256 z repo.json).
_pag_ok() {
    local p="$1" expected="$2"
    [[ -s "$p" ]] || return 1
    if [[ -n "$expected" ]] && _have sha256sum; then
        local got
        got="$(sha256sum "$p" | awk '{print $1}')"
        [[ "$got" == "$expected" ]] || return 1
    fi
    return 0
}

# Pobierz pakiet .pag (z cache) i zwróć ścieżkę.
_fetch_pag() {
    local name="$1" file sha out
    file="$(python3 "$PY_HELPER" field "$INDEX_JSON" "$name" filename 2>/dev/null || true)"
    [[ -n "$file" ]] || die "Pakiet '$name' nie istnieje w repo (sprawdź: pag search $name)"
    sha="$(python3 "$PY_HELPER" field "$INDEX_JSON" "$name" sha256 2>/dev/null || true)"
    out="$PKG_CACHE/$file"

    # Cache mógł zostać przerwany w poprzednim buildzie (0 B / uszkodzony plik).
    # Tak powstał m.in. libxcrypt-*.pag.part: sam plik docelowy był pusty,
    # a kolejne uruchomienie nie ponawiało pobrania.
    if ! _pag_ok "$out" "$sha"; then
        [[ -e "$out" ]] && rm -f "$out"
        if [[ -s "$BOOTSTRAP_CACHE/$file" ]] && _pag_ok "$BOOTSTRAP_CACHE/$file" "$sha"; then
            cp -f "$BOOTSTRAP_CACHE/$file" "$out"
        else
            rm -f "$out.part"
            if ! pb_run "pobieranie $file" wget -q \
                    --tries=5 --timeout=30 --waitretry=2 --retry-connrefused \
                    -O "$out.part" "${PAGAN_REPO_URL%/}/$file"; then
                rm -f "$out.part"
                _log "      URL: ${PAGAN_REPO_URL%/}/$file"
                _log "      Sprawdź sieć/DNS. Ponowna próba: uruchom build jeszcze raz."
                die "Nie mogę pobrać $file z repo"
            fi
            if [[ -n "$sha" ]] && _have sha256sum; then
                local got
                got="$(sha256sum "$out.part" | awk '{print $1}')"
                if [[ "$got" != "$sha" ]]; then
                    rm -f "$out.part"
                    die "SHA256 $file nie zgadza się z repo.json (oczekiwano $sha, jest $got)"
                fi
            fi
            mv -f "$out.part" "$out"
        fi
    fi
    printf '%s' "$out"
}

# ========================= ROOTFS: BAZA PLIKOWA =========================
# ── usrmerge (Pagan jest systemem merged-usr) ─────────────────────────────
# Pakiety (systemd, depmod, RPATH /usr/lib64/systemd) są budowane pod
# /usr/lib/modules i /usr/lib/systemd. Builder v2 wcześniej zostawiał split-usr
# (/lib, /bin, /sbin jako realne katalogi), co psuło systemctl, sysusers,
# depmod i moduły w initramfs. Ten krok scala je jak w v1/_usrmerge_rootfs.
_usrmerge_move() {   # $1=src, $2=dst – dokłada TYLKO brakujące, nie nadpisuje /usr
    local src="$1" dst="$2" f b t abs rel
    [[ -d "$src" && ! -L "$src" ]] || return 0
    mkdir -p "$dst"
    for f in "$src"/* "$src"/.[!.]* "$src"/..?*; do
        [[ -e "$f" || -L "$f" ]] || continue
        b="${f##*/}"
        if [[ -L "$f" ]]; then
            [[ -e "$dst/$b" || -L "$dst/$b" ]] && continue
            # Cel linku przeliczamy W OBRĘBIE rootfs (absolutny cel odnosimy do
            # $PAGAN_ROOT, nie do hosta), a potem tworzymy link względny z nowej
            # lokalizacji. Bez tego /sbin/sh -> ../usr/bin/bash trafiał do
            # /usr/bin i wskazywał /usr/usr/bin/bash (albo był po cichu gubiony).
            t="$(readlink "$f" 2>/dev/null || true)"
            if [[ "$t" == /* ]]; then
                abs="$PAGAN_ROOT$t"
            else
                abs="$(dirname "$f")/$t"
            fi
            abs="$(realpath -m "$abs" 2>/dev/null || true)"
            if [[ -z "$abs" || "$abs" != "$PAGAN_ROOT"/* ]]; then
                cp -a "$f" "$dst/$b" 2>/dev/null || true      # cel poza rootfs
                continue
            fi
            [[ "$abs" == "$(realpath -m "$dst/$b" 2>/dev/null || echo x)" ]] && continue
            rel="$(realpath --relative-to="$(dirname "$dst/$b")" "$abs" 2>/dev/null || true)"
            if [[ -n "$rel" ]]; then
                ln -sfn "$rel" "$dst/$b" 2>/dev/null || cp -a "$f" "$dst/$b" 2>/dev/null || true
            else
                cp -a "$f" "$dst/$b" 2>/dev/null || true
            fi
        elif [[ -d "$f" ]]; then
            # Katalog: scal rekurencyjnie. Płytkie `cp -a` gubiło pliki, gdy
            # podkatalog istniał już w /usr (np. /lib/udev vs /usr/lib/udev).
            # -d podąża za symlinkiem, więc /usr/sbin→bin też jest scalane.
            if [[ -e "$dst/$b" && ! -d "$dst/$b" ]]; then
                continue
            elif [[ -d "$dst/$b" ]]; then
                _usrmerge_move "$f" "$dst/$b"
            else
                cp -a "$f" "$dst/$b" 2>/dev/null || true
            fi
        else
            [[ -e "$dst/$b" || -L "$dst/$b" ]] && continue
            cp -a "$f" "$dst/$b" 2>/dev/null || true
        fi
    done
}

_usrmerge_rootfs_v2() {
    local R="$PAGAN_ROOT"
    [[ -n "$R" && "$R" != "/" ]] || return 1

    # Nasze wcześniejsze obejścia split-usr – precz (mogłyby wskazać same na siebie).
    [[ -L "$R/lib/systemd" ]] && rm -f "$R/lib/systemd"
    [[ -L "$R/lib/modules" ]] && rm -f "$R/lib/modules"
    [[ -L "$R/lib64" ]] && rm -f "$R/lib64"
    [[ -L "$R/usr/lib64" ]] && rm -f "$R/usr/lib64"

    _usrmerge_move "$R/lib"       "$R/usr/lib"
    _usrmerge_move "$R/lib64"     "$R/usr/lib"
    _usrmerge_move "$R/usr/lib64" "$R/usr/lib"
    _usrmerge_move "$R/bin"       "$R/usr/bin"
    _usrmerge_move "$R/sbin"      "$R/usr/bin"
    _usrmerge_move "$R/usr/sbin"  "$R/usr/bin"

    [[ -d "$R/lib"       && ! -L "$R/lib" ]]       && rm -rf "$R/lib"
    [[ -d "$R/lib64"     && ! -L "$R/lib64" ]]     && rm -rf "$R/lib64"
    [[ -d "$R/usr/lib64" && ! -L "$R/usr/lib64" ]] && rm -rf "$R/usr/lib64"
    [[ -d "$R/bin"       && ! -L "$R/bin" ]]       && rm -rf "$R/bin"
    [[ -d "$R/sbin"      && ! -L "$R/sbin" ]]      && rm -rf "$R/sbin"
    [[ -d "$R/usr/sbin"  && ! -L "$R/usr/sbin" ]]  && rm -rf "$R/usr/sbin"

    mkdir -p "$R/usr/bin" "$R/usr/lib"
    ln -sfn usr/lib "$R/lib"
    ln -sfn usr/lib "$R/lib64"
    ln -sfn usr/bin "$R/bin"
    ln -sfn usr/bin "$R/sbin"
    ln -sfn bin     "$R/usr/sbin"
    ln -sfn lib     "$R/usr/lib64"

    rm -rf "$R/var/run";  ln -sfn ../run "$R/var/run"
    rm -rf "$R/var/lock"; ln -sfn ../run/lock "$R/var/lock"

    # Linker dynamiczny: przy pustym szkielecie jeszcze go nie ma – ostrzegamy
    # tylko gdy rootfs jest już zamieszkany (bootstrap sam to weryfikuje).
    if [[ -e "$R/usr/bin/bash" && ! -e "$R/usr/lib/ld-linux-x86-64.so.2" ]]; then
        warn "usrmerge: brak /usr/lib/ld-linux-x86-64.so.2"
    fi
}

_prepare_rootfs_skeleton() {
    pb_phase "SZKIELET ROOTFS" "tworzę drzewo katalogów w ${PAGAN_ROOT}"
    if (( REBUILD )); then
        # Bezpieczeństwo: nie kasujemy punktu montowania (np. gdy ktoś podał
        # --root na zamontowany dysk).
        mountpoint -q "$PAGAN_ROOT" && die "--rebuild: $PAGAN_ROOT jest punktem montowania – odmontuj go najpierw."
        _umount_vfs
        # --one-file-system: NIGDY nie wchodzimy w pozostałe montowania
        # (rbind /dev, /sys, /proc). Bez tego rm -rf kasował WĘZŁY URZĄDZEŃ
        # HOSTA – objaw: znikający /dev/null i padający sshd.
        warn "--rebuild: czyszczę $PAGAN_ROOT (bez wchodzenia w montowania)"
        rm -rf --one-file-system "$PAGAN_ROOT"
    fi
    mkdir -p "$PAGAN_ROOT"/{boot,dev,etc,home,proc,root,run,sys,tmp,usr,var}
    mkdir -p "$PAGAN_ROOT"/{dev/pts,etc/pag,etc/systemd/system,var/lib/pag,var/cache/pag,var/log,usr/share/pag}
    mkdir -p "$PAGAN_ROOT/usr"/{bin,lib,sbin}
    chmod 1777 "$PAGAN_ROOT/tmp"
    chmod 700 "$PAGAN_ROOT/root"

    # merged-usr OD RAZU: bootstrap i pakiety rozpakują się prosto do /usr.
    _usrmerge_rootfs_v2

    ok "katalogi bazowe utworzone (merged-usr: /lib,/bin,/sbin → /usr)"
}

# ========================= BOOTSTRAP Z REPO =========================
# Bootstrap rozpakowuje data.tar.xz BEZ hooków. To jest celowe: w tym momencie
# nie ma jeszcze działającego `pag`, więc nie ma jak przeprowadzić transakcji.
# Późniejszy `pag install` reinstaluje większość tych pakietów i wtedy hooki
# się wykonują. Wyjątkiem są pakiety z SYSTEM_BASE w pag (glibc, bash,
# coreutils, perl…): resolver celowo je pomija jako zależności, więc nie trafiają
# do installed.json. Dlatego:
#   • bash: odtwarzamy /etc/shells (patrz _seed_base_files),
#   • glibc: localedef + ldconfig robi _post_bootstrap_fixups/_phase_configure,
#   • wszystkie: manifest base.json + `pag base register` w _phase_release,
#     żeby `pag upgrade` je widział (rolling obejmował też bazę).
_write_base_manifest() {
    local out="$PAGAN_ROOT/usr/share/pag/base.json"
    local txt="$PAGAN_ROOT/usr/share/pag/base-packages.txt"
    local n=$#
    mkdir -p "$(dirname "$out")"
    python3 - "$INDEX_JSON" "$out" "$txt" "$PAGAN_VERSION" "$PAGAN_DE" "$@" <<'PY'
import json, sys
idx_path, out, txt, ver, de = sys.argv[1:6]
names = sys.argv[6:]
pkgs = {p.get("name"): p for p in json.load(open(idx_path)).get("packages", [])}
entries = []
with open(txt, "w", encoding="utf-8") as fh:
    for n in names:
        p = pkgs.get(n) or {}
        v = p.get("version", "?")
        entries.append({"name": n, "version": v})
        fh.write(f"{n} {v}\n")
json.dump({"iso_version": ver, "de": de, "packages": entries},
          open(out, "w"), indent=2, ensure_ascii=False)
PY
    chmod 644 "$out" "$txt" 2>/dev/null || true
    ok "manifest bazy: base.json + base-packages.txt ($n pakietów bootstrapu)"
}

_phase_bootstrap() {
    pb_phase "BOOTSTRAP Z REPO PAG" "rozpakowuję glibc, bash, python, pag i ich zależności (bez hooków)"
    local list
    mapfile -t list < <(python3 "$PY_HELPER" resolve "$INDEX_JSON" "${BOOTSTRAP_SEEDS[@]}" 2>"$WORK_DIR/resolve.err" || true)
    if [[ -s "$WORK_DIR/resolve.err" ]]; then
        grep -o 'MISSING:[^ ]*' "$WORK_DIR/resolve.err" | sed 's/MISSING:/  (brak w repo, pomijam): /' | tee -a "$LOG_FILE" >&2 || true
    fi
    ((${#list[@]})) || die "Resolver nie zwrócił żadnych pakietów bootstrapu."
    _log "  bootstrap: ${#list[@]} pakietów (z zależnościami)"
    _write_base_manifest "${list[@]}"

    local n=0 name pag total=${#list[@]}
    for name in "${list[@]}"; do
        n=$((n+1))
        pag="$(_fetch_pag "$name")"
        printf '  [%d/%d] %s\n' "$n" "$total" "$name" >> "$LOG_FILE"
        if ! pb_run "[$n/$total] rozpakowanie $name" python3 "$PY_HELPER" extract "$pag" "$PAGAN_ROOT"; then
            pb_tail 10
            die "Nie udało się rozpakować $name ($pag)"
        fi
    done
    ok "bootstrap rozpakowany (${#list[@]} pakietów, $(pb_fmt_time $(( SECONDS - PB_PHASE_T0 ))))"

    # Dynamiczny linker musi istnieć – inaczej chroot nie wstanie.
    [[ -e "$PAGAN_ROOT/lib64/ld-linux-x86-64.so.2" || -e "$PAGAN_ROOT/lib/ld-linux-x86-64.so.2" ]] \
        || die "Brak ld-linux w rootfs po bootstrapie (glibc nie rozpakowana?)"

    # Podstawowe pliki systemu (muszą istnieć ZANIM wejdziemy w chroot).
    _seed_base_files
}

_seed_base_files() {
    # passwd/group (jeśli glibc/shadow ich nie wniosły), fstab, hosts, resolv.
    [[ -s "$PAGAN_ROOT/etc/passwd" ]] || cat > "$PAGAN_ROOT/etc/passwd" <<'EOF'
root:x:0:0:root:/root:/bin/bash
bin:x:1:1:bin:/dev/null:/usr/bin/nologin
daemon:x:2:2:daemon:/dev/null:/usr/bin/nologin
nobody:x:65534:65534:nobody:/:/usr/bin/nologin
EOF
    [[ -s "$PAGAN_ROOT/etc/group" ]] || cat > "$PAGAN_ROOT/etc/group" <<'EOF'
root:x:0:
bin:x:1:bin,daemon
daemon:x:2:bin,daemon
wheel:x:10:
users:x:100:
nobody:x:65534:
EOF
    [[ -s "$PAGAN_ROOT/etc/shadow" ]] || { touch "$PAGAN_ROOT/etc/shadow"; chmod 600 "$PAGAN_ROOT/etc/shadow"; }
    if ! grep -q '^root:' "$PAGAN_ROOT/etc/shadow" 2>/dev/null; then
        printf 'root::19000:0:99999:7:::\n' >> "$PAGAN_ROOT/etc/shadow"
    fi

    cat > "$PAGAN_ROOT/etc/fstab" <<'EOF'
# <file system>  <dir>  <type>  <options>            <dump> <pass>
# Wypełnia instalator przy instalacji na dysk.
EOF
    cat > "$PAGAN_ROOT/etc/hosts" <<'EOF'
127.0.0.1   localhost
::1         localhost
EOF
    printf 'pagan-live\n' > "$PAGAN_ROOT/etc/hostname"

    # /etc/shells – normalnie robi to hook post-install pakietu bash. Bootstrap
    # nie uruchamia hooków, a bash jest w SYSTEM_BASE (pag go nie reinstaluje),
    # więc bez tego chsh/PAM/niektóre aplikacje nie widzą ważnych powłok.
    if [[ ! -s "$PAGAN_ROOT/etc/shells" ]]; then
        cat > "$PAGAN_ROOT/etc/shells" <<'EOF'
# /etc/shells: valid login shells
/bin/sh
/bin/bash
/usr/bin/sh
/usr/bin/bash
EOF
    else
        local _sh
        for _sh in /bin/sh /bin/bash /usr/bin/sh /usr/bin/bash; do
            grep -qxF "$_sh" "$PAGAN_ROOT/etc/shells" 2>/dev/null \
                || printf '%s\n' "$_sh" >> "$PAGAN_ROOT/etc/shells"
        done
    fi
    chmod 644 "$PAGAN_ROOT/etc/shells" 2>/dev/null || true

    # repos.conf – jedno repo na linię (format PAG).
    cat > "$PAGAN_ROOT/etc/pag/repos.conf" <<EOF
# Pagan Linux – repozytoria PAG (jedno URL na linię)
${PAGAN_REPO_URL%/}
EOF
    chmod 644 "$PAGAN_ROOT/etc/pag/repos.conf"

    # DNS, żeby pag w chroocie rozwiązał repo.
    cat > "$PAGAN_ROOT/etc/resolv.conf" <<'EOF'
nameserver 1.1.1.1
nameserver 9.9.9.9
EOF
    ok "pliki bazowe (passwd/group/fstab/hosts/repos.conf/resolv.conf)"
}

_vfs_mount() {
    (( _VFS_MOUNTED )) && return 0
    local rp d
    rp="$(_safe_pagan_root)" || die "Niebezpieczny PAGAN_ROOT='${PAGAN_ROOT:-}' – odmawiam montowania."
    PAGAN_ROOT="$rp"
    # Stale montowania z przerwanego builda: bez tego `mount --rbind` nakłada
    # kolejną warstwę na /dev i póżniejsze `rm -rf $PAGAN_ROOT` / `mv` potrafi
    # wejść przez bind-mount w HOSTOWY /dev (objaw: znikający /dev/null).
    _umount_vfs
    for d in dev proc sys run; do
        [[ -L "$PAGAN_ROOT/$d" ]] && \
            die "$PAGAN_ROOT/$d jest symlinkiem – odmawiam montowania (ryzyko zdjęcia HOSTA)."
        mkdir -p "$PAGAN_ROOT/$d"
    done
    mount --rbind /dev "$PAGAN_ROOT/dev"
    mount --make-rslave "$PAGAN_ROOT/dev"
    mount -t proc proc "$PAGAN_ROOT/proc"
    mount --rbind /sys "$PAGAN_ROOT/sys"; mount --make-rslave "$PAGAN_ROOT/sys"
    mount --rbind /run "$PAGAN_ROOT/run"; mount --make-rslave "$PAGAN_ROOT/run"
    _VFS_MOUNTED=1
}

_c() { chroot "$PAGAN_ROOT" /usr/bin/env -i \
        PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin \
        HOME=/root TERM="${TERM:-linux}" LANG=C.UTF-8 \
        SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt \
        SSL_CERT_DIR=/etc/ssl/certs \
        PAG_YES=1 PAG_INSECURE=1 "$@"; }

# Ręczny bootstrap rozpakowuje data.tar.xz BEZ uruchamiania hooków pakietów, więc
# odtwarzamy to, co normalnie robi post-install – inaczej rootfs bywa „prawie”
# spójny (brak cache ld, brak kont systemowych, brak CA).
_post_bootstrap_fixups() {
    local x

    # ── CA bundle ───────────────────────────────────────────────────────────
    # W świeżo rozpakowanym rootfsie Python/urllib paga NIE ma czym zweryfikować
    # certyfikatu repo („CERTIFICATE_VERIFY_FAILED / unable to get local issuer
    # certificate”). update-ca-certificates bywa zawodne bez pełnego drzewa,
    # dlatego bierzemy GOTOWY bundle z hosta – jest identyczny i pewny.
    if [[ ! -s "$PAGAN_ROOT/etc/ssl/certs/ca-certificates.crt" && -s /etc/ssl/certs/ca-certificates.crt ]]; then
        install -Dm644 /etc/ssl/certs/ca-certificates.crt \
            "$PAGAN_ROOT/etc/ssl/certs/ca-certificates.crt"
        ok "CA bundle (skopiowany z hosta)"
    fi
    # Uzupełnij też katalog certyfikatów (część bibliotek patrzy na SSL_CERT_DIR).
    if [[ -d /etc/ssl/certs && ! -e "$PAGAN_ROOT/etc/ssl/certs/ca-certificates.crt" ]]; then
        mkdir -p "$PAGAN_ROOT/etc/ssl/certs"
        cp -a /etc/ssl/certs/. "$PAGAN_ROOT/etc/ssl/certs/" 2>/dev/null || true
    fi

    for x in /usr/sbin/ldconfig /sbin/ldconfig; do
        if [[ -x "$PAGAN_ROOT$x" ]]; then
            _c "$x" >>"$LOG_FILE" 2>&1 && ok "ldconfig" || warn "ldconfig – pominięte"
            break
        fi
    done
    [[ -x "$PAGAN_ROOT/usr/bin/systemd-sysusers" ]] \
        && { _c /usr/bin/systemd-sysusers >>"$LOG_FILE" 2>&1 && ok "systemd-sysusers"; } || true
    [[ -x "$PAGAN_ROOT/usr/bin/systemd-tmpfiles" ]] \
        && { _c /usr/bin/systemd-tmpfiles --create >>"$LOG_FILE" 2>&1 && ok "systemd-tmpfiles"; } || true
    [[ -x "$PAGAN_ROOT/usr/sbin/update-ca-certificates" ]] \
        && { _c /usr/sbin/update-ca-certificates >>"$LOG_FILE" 2>&1 && ok "ca-certificates"; } || true
    return 0
}

# ========================= INSTALACJA STACKU (pag) =========================
_phase_install_stack() {
    local _de_desc="XFCE4 (Xorg)"
    [[ "${PAGAN_DE,,}" == "luna" ]] && _de_desc="Luna (Selene/Wayland + libLuna)"
    pb_phase "INSTALACJA STACKU Z REPO" "jądro, firmware, dźwięk (PipeWire/ALSA/UCM), grafika (Mesa/NVIDIA), sieć, ${_de_desc}, GRUB"
    _vfs_mount

    # pag musi działać w chrocie.
    # merged-usr również przy --reuse-rootfs (stary rootfs mógł być split).
    _usrmerge_rootfs_v2

    _c /usr/bin/pag --version >/dev/null 2>&1 \
        || die "pag nie uruchamia się w chrocie (bootstrap niekompletny?)"

    _post_bootstrap_fixups

    pb_run_ok "pag update (odświeżenie indeksu)" _c /usr/bin/pag update || true

    local stack=()
    if [[ "${PAGAN_DE,,}" == "luna" ]]; then
        stack=("${STACK_LUNA[@]}")
    else
        stack=("${STACK_BASE[@]}")
    fi
    (( NO_NVIDIA )) || stack+=("${STACK_NVIDIA[@]}")
    (( NO_NVIDIA )) && warn "Pomijam NVIDIA (--no-nvidia)"

    # Instalujemy w PACZKACH, żeby pojedynczy brak nie ubił całości, i logujemy
    # realny powód (pag jest fail-closed przy konfliktach plików).
    local p failed=() n=0 total=${#stack[@]}
    for p in "${stack[@]}"; do
        n=$((n+1))
        if pb_run "[$n/$total] pag install $p" _c /usr/bin/pag install -y "$p"; then
            ok "[$n/$total] z repo: $p"
        else
            warn "[$n/$total] nie udało się: $p (szczegóły w $LOG_FILE)"
            failed+=("$p")
        fi
    done
    # Druga próba dla nieudanych – teraz gdy reszta zależności jest na dysku.
    if ((${#failed[@]})); then
        _log "  → druga próba dla: ${failed[*]}"
        for p in "${failed[@]}"; do
            if pb_run "druga próba: pag install $p" _c /usr/bin/pag install -y "$p"; then
                ok "z repo (2. próba): $p"
            else
                warn "NADAL nieudane: $p"
            fi
        done
    fi

    # Krytyczne elementy – bez nich obraz jest bezużyteczny. Sprawdzam PLIKI
    # (pewniejsze niż parsowanie `pag list`).
    local -A _crit=(
        [kernel]="/usr/lib/modules"
        [grub]="/usr/bin/grub-mkconfig"
    )
    if [[ "${PAGAN_DE,,}" == "luna" ]]; then
        _crit[selene]="/usr/bin/selene"
        _crit[luna-session]="/usr/bin/luna-session"
        _crit[luna-installer]="/usr/bin/luna-installer"
        _crit[greetd]="/usr/bin/greetd"
    else
        _crit[xfce4]="/usr/bin/xfce4-session"
        _crit[lightdm]="/usr/bin/lightdm"
    fi
    local k
    for k in "${!_crit[@]}"; do
        [[ -e "$PAGAN_ROOT${_crit[$k]}" || -e "$PAGAN_ROOT/usr/sbin/${_crit[$k]##*/}" ]] \
            || warn "KRYTYCZNE: brak '$k' (${_crit[$k]}) w systemie!"
    done
    [[ -e "$PAGAN_ROOT/usr/sbin/NetworkManager" || -e "$PAGAN_ROOT/usr/bin/NetworkManager" ]] \
        || warn "KRYTYCZNE: brak 'networkmanager' w systemie!"
    ok "stack zainstalowany (${#stack[@]} pakietów, $(pb_fmt_time $(( SECONDS - PB_PHASE_T0 ))))"
}

# ========================= WERYFIKACJA DŹWIĘKU I GRAFIKI =========================
# Diagnostyka (nie przerywa builda): konkretnie pokazuje, czego brakuje w rootfs,
# zamiast zostawiać użytkownika z „chyba działa”. Sprawdza warstwę jądra,
# firmware, PipeWire/ALSA UCM oraz Mesa/GL/Vulkan/Xorg/NVIDIA.
_verify_audio_graphics() {
    _log ""
    _log "${C_B}▶ STEROWNIKI: DŹWIĘK I GRAFIKA${C_0}"
    local kver="" miss_audio=0 miss_gfx=0 b

    kver="$(ls -1 "$PAGAN_ROOT/usr/lib/modules" 2>/dev/null | head -n1 || true)"
    if [[ -n "$kver" && -d "$PAGAN_ROOT/usr/lib/modules/$kver/kernel/sound" ]]; then
        ok "audio: moduły jądra snd_* ($kver)"
    else
        warn "audio: brak modułów kernel/sound dla jądra ${kver:-?}"
        miss_audio=1
    fi

    if [[ -d "$PAGAN_ROOT/usr/lib/firmware" ]]; then
        ok "firmware: /usr/lib/firmware (linux-firmware)"
    else
        warn "firmware: brak /usr/lib/firmware – GPU/audio mogą nie wstać"
        miss_audio=1; miss_gfx=1
    fi
    if ls "$PAGAN_ROOT/usr/lib/firmware/intel/" 2>/dev/null | grep -qi 'sof'; then
        ok "audio: firmware SOF (Intel DSP)"
    else
        warn "audio: brak firmware SOF (sof-firmware) – część laptopów Intel bez dźwięku"
        miss_audio=1
    fi
    if [[ -d "$PAGAN_ROOT/usr/share/alsa/ucm2" ]]; then
        ok "audio: profile UCM (alsa-ucm-conf)"
    else
        warn "audio: brak /usr/share/alsa/ucm2 (alsa-ucm-conf) – przełączanie wyjść może nie działać"
        miss_audio=1
    fi
    for b in /usr/bin/pipewire /usr/bin/wireplumber /usr/bin/pipewire-pulse; do
        if [[ -x "$PAGAN_ROOT$b" ]]; then ok "audio: ${b##*/}"
        else warn "audio: brak $b"; miss_audio=1; fi
    done

    # Grafika: Mesa DRI + GL/EGL + Vulkan ICD + moduły Xorg.
    if ls "$PAGAN_ROOT/usr/lib/dri/"*_dri.so >/dev/null 2>&1; then
        ok "grafika: sterowniki DRI/Mesa"
    else
        warn "grafika: brak /usr/lib/dri/*_dri.so (mesa)"; miss_gfx=1
    fi
    for b in /usr/lib/libGL.so.1 /usr/lib/libEGL.so.1 /usr/lib/libvulkan.so.1; do
        if [[ -e "$PAGAN_ROOT$b" ]]; then ok "grafika: ${b##*/}"
        else warn "grafika: brak $b"; miss_gfx=1; fi
    done
    if ls "$PAGAN_ROOT/usr/share/vulkan/icd.d/"*.json >/dev/null 2>&1; then
        ok "grafika: Vulkan ICD"
    else
        warn "grafika: brak ICD Vulkan"; miss_gfx=1
    fi
    if [[ "${PAGAN_DE,,}" == "luna" ]]; then
        # Luna nie używa Xorga – liczy się kompozytor Wayland i sesja.
        for b in /usr/bin/selene /usr/bin/luna-session /usr/bin/greetd; do
            if [[ -x "$PAGAN_ROOT$b" ]]; then ok "Luna: ${b##*/}"
            else warn "Luna: brak $b"; miss_gfx=1; fi
        done
    else
        if [[ -d "$PAGAN_ROOT/usr/lib/xorg/modules/drivers" ]]; then
            ok "grafika: moduły Xorg"
        else
            warn "grafika: brak modułów Xorg"; miss_gfx=1
        fi
    fi

    if (( ! NO_NVIDIA )); then
        if ls "$PAGAN_ROOT/usr/lib/modules/$kver/kernel/drivers/video/"nvidia*.ko* >/dev/null 2>&1; then
            ok "grafika: moduły NVIDIA ($kver)"
        else
            warn "grafika: brak nvidia*.ko – NVIDIA nie wystartuje"; miss_gfx=1
        fi
        if ls "$PAGAN_ROOT/usr/lib/"libGLX_nvidia.so* >/dev/null 2>&1; then
            ok "grafika: userspace NVIDIA (libGLX_nvidia)"
        else
            warn "grafika: brak libGLX_nvidia – brak akceleracji NVIDIA"; miss_gfx=1
        fi
    fi

    if (( miss_audio || miss_gfx )); then
        _log "  ${C_Y}Uwaga:${C_0} braki powyżej dotyczą tego obrazu; szczegóły: $LOG_FILE"
    else
        ok "dźwięk i grafika: komplet składników w rootfs"
    fi
    return 0
}

# ========================= KONFIGURACJA SYSTEMU =========================
# kmod 34.2-5 w repo był zbudowany błędnie (tylko licencja, bez binarek).
# Dopóki nowy pakiet nie trafi do repo, uzupełniamy depmod/modprobe z hosta
# (host ma ten sam kmod 34.2), żeby modules.dep zawierał NVIDIA i moduły DKMS.
_ensure_kmod_tools() {
    if [[ -x "$PAGAN_ROOT/usr/bin/depmod" || -L "$PAGAN_ROOT/usr/bin/depmod" ]]; then
        return 0
    fi
    if [[ ! -x /usr/bin/kmod ]]; then
        warn "kmod: brak depmod w obrazie i na hoście – modules.dep może być nieaktualny"
        return 0
    fi
    warn "kmod: brak depmod/modprobe w obrazie – importuję z hosta ($(kmod --version 2>/dev/null | head -n1))"
    mkdir -p "$PAGAN_ROOT/usr/bin"
    cp -fL /usr/bin/kmod "$PAGAN_ROOT/usr/bin/kmod"
    local _b
    for _b in modprobe depmod insmod rmmod lsmod modinfo; do
        ln -sfn kmod "$PAGAN_ROOT/usr/bin/$_b"
    done
    # /sbin jest symlinkiem do usr/bin (merged-usr), więc modprobe jest już
    # osiągalne jako /sbin/modprobe – nie tworzymy tam osobnego dowiązania.
    ok "kmod: depmod/modprobe/modinfo → obraz (z hosta)"
}

# ========================= LUNA: greetd + konto greetera =========================
# Luna nie używa LightDM ani Xorga. Logowanie obsługuje greetd z
# `luna-greeter-session`, a w live sesję startuje getty@tty1 (autologin root)
# → /etc/profile.d/pagan-live.sh → luna-session.
_configure_luna() {
    [[ "${PAGAN_DE,,}" == "luna" ]] || return 0

    # Konto `greeter` musi istnieć i mieć dostęp do DRM/input. Pakiety dowożą
    # tylko PRZYKŁAD configu (luna-greeter), więc tworzymy je przez sysusers.
    # Idempotentne – działa też przy --reuse-rootfs.
    mkdir -p "$PAGAN_ROOT/usr/lib/sysusers.d"
    cat > "$PAGAN_ROOT/usr/lib/sysusers.d/luna-greeter.conf" <<'EOF'
g video -
g render -
g input -
u greeter - "Luna Greeter" /var/lib/greeter /sbin/nologin
m greeter video
m greeter render
m greeter input
EOF
    if [[ -x "$PAGAN_ROOT/usr/bin/systemd-sysusers" ]]; then
        _c /usr/bin/systemd-sysusers >>"$LOG_FILE" 2>&1 \
            && ok "Luna: konto greeter (sysusers)" \
            || warn "Luna: systemd-sysusers – nie udało się utworzyć greetera"
    fi
    mkdir -p "$PAGAN_ROOT/var/lib/greeter"
    # chown po NUMERACH – host nie zna użytkownika greeter z rootfs.
    local _guid _ggid
    _guid="$(awk -F: '$1=="greeter"{print $3}' "$PAGAN_ROOT/etc/passwd" 2>/dev/null | head -n1)"
    _ggid="$(awk -F: '$1=="greeter"{print $3}' "$PAGAN_ROOT/etc/group" 2>/dev/null | head -n1)"
    if [[ -n "$_guid" && -n "$_ggid" ]]; then
        chown "$_guid:$_ggid" "$PAGAN_ROOT/var/lib/greeter" 2>/dev/null || true
    fi
    chmod 750 "$PAGAN_ROOT/var/lib/greeter" 2>/dev/null || true

    # greetd: greeter Luny. W live jednostka jest pomijana warunkiem
    # ConditionKernelCommandLine (ma Conflicts=getty@tty1.service).
    mkdir -p "$PAGAN_ROOT/etc/greetd" \
             "$PAGAN_ROOT/etc/systemd/system/greetd.service.d"
    cat > "$PAGAN_ROOT/etc/greetd/config.toml" <<'EOF'
[terminal]
vt = 1

[default_session]
command = "luna-greeter-session"
user = "greeter"
EOF
    cat > "$PAGAN_ROOT/etc/systemd/system/greetd.service.d/10-pagan-live.conf" <<'EOF'
[Unit]
# Live: Lunę startuje getty@tty1 (autologin root) przez /etc/profile.d/pagan-live.sh.
# greetd ma Conflicts=getty@tty1.service, więc w live musi zostać pominięty.
ConditionKernelCommandLine=!pagan.live
EOF
    _c /usr/bin/systemctl enable greetd >>"$LOG_FILE" 2>&1 \
        && ok "enable: greetd (luna-greeter-session)" \
        || warn "enable: greetd (jednostka może być w pakiecie z presetem)"

    [[ -x "$PAGAN_ROOT/usr/bin/Xwayland" ]] \
        || warn "Luna: brak Xwayland – aplikacje X11 nie wystartują"
}

_phase_configure() {
    pb_phase "KONFIGURACJA SYSTEMU" "użytkownicy, locale, usługi systemd, GRUB /etc/default/grub, NVIDIA KMS, initramfs"

    # Także przy --reuse-rootfs: dopełnij usrmerge (idempotentne).
    _usrmerge_rootfs_v2
    if ! _c /usr/bin/systemctl --version >/dev/null 2>&1; then
        warn "systemctl w chroot nie działa – enable/set-default mogą się nie udać"
    fi

    # Konto użytkownika live + hasło roota (puste, jak w typowym live).
    printf 'root::19000:0:99999:7:::\n' > "$PAGAN_ROOT/etc/shadow.tmp"
    grep -v '^root:' "$PAGAN_ROOT/etc/shadow" >> "$PAGAN_ROOT/etc/shadow.tmp" || true
    mv -f "$PAGAN_ROOT/etc/shadow.tmp" "$PAGAN_ROOT/etc/shadow"
    chmod 600 "$PAGAN_ROOT/etc/shadow"

    # locale
    if [[ -x "$PAGAN_ROOT/usr/bin/localedef" ]]; then
        for loc in en_US.UTF-8 pl_PL.UTF-8; do
            _c /usr/bin/localedef -i "${loc%.*}" -f UTF-8 "$loc" >>"$LOG_FILE" 2>&1 \
                && ok "locale: $loc" || true
        done
    fi

    # /etc/shells – wpisy dodaje configure_shells (niżej) dla bash i zsh.
    [[ -s "$PAGAN_ROOT/etc/shells" ]] \
        && ok "shells: /etc/shells istnieje (bash/zsh dopisze configure_shells)" \
        || warn "shells: brak /etc/shells – configure_shells go utworzy"

    # Powłoki i podpowiedzi AI: zsh (domyślna interaktywna) + bash + pagan-ai.
    # Musi być tutaj (przed pakowaniem), bo _phase_pack dopiero source'uje v1.
    if declare -F configure_shells >/dev/null 2>&1; then
        configure_shells
    else
        warn "brak pagan-shells.sh – powłoki i AI NIE skonfigurowane"
    fi

    # Strefa czasowa (domyślnie Europe/Warsaw, jak cały projekt).
    ln -sf /usr/share/zoneinfo/Europe/Warsaw "$PAGAN_ROOT/etc/localtime" 2>/dev/null || true

    # pam_namespace: plik wzorcowy (wszystko zakomentowane = bez
    # polyinstantacji, jak w typowych dystrybucjach). Bez niego verify_rootfs
    # zgłasza brak, mimo że PAM działa bezpiecznie.
    if [[ ! -f "$PAGAN_ROOT/etc/security/namespace.conf" ]]; then
        mkdir -p "$PAGAN_ROOT/etc/security"
        cat > "$PAGAN_ROOT/etc/security/namespace.conf" <<'NSEOF'
# /etc/security/namespace.conf
#
# See /usr/share/doc/pam-*/txts/README.pam_namespace for more information.
#
#/tmp     /tmp-inst/            level      root,adm
#/var/tmp /var/tmp/tmp-inst/    level      root,adm
#$HOME    $HOME/$USER.inst/     level
NSEOF
        ok "security: /etc/security/namespace.conf (pam_namespace)"
    fi

    # machine-id
    if [[ ! -s "$PAGAN_ROOT/etc/machine-id" ]]; then
        _c /usr/bin/systemd-machine-id-setup >/dev/null 2>&1 || true
        [[ -s "$PAGAN_ROOT/etc/machine-id" ]] || \
            od -An -tx1 -N16 /dev/urandom | tr -d ' \n' > "$PAGAN_ROOT/etc/machine-id" || true
        chmod 444 "$PAGAN_ROOT/etc/machine-id" 2>/dev/null || true
    fi

    # Moduły: /lib jest symlinkiem do usr/lib (merged-usr), więc /lib/modules
    # rozwiązuje się do /usr/lib/modules bez dodatkowych dowiązań. Sprawdzamy
    # tylko, czy usrmerge faktycznie objął /lib.
    if [[ -d "$PAGAN_ROOT/usr/lib/modules" && ! -L "$PAGAN_ROOT/lib" ]]; then
        warn "moduły: /lib nie jest symlinkiem (usrmerge nieobjęty?) – poprawiam"
        _usrmerge_rootfs_v2
    fi

    _ensure_kmod_tools

    # depmod po instalacji jądra i NVIDIA: modules.dep musi zawierać nvidia-drm,
    # inaczej moduł jest na dysku, ale udev/modprobe go nie znajdzie.
    local _kver _depmod
    _kver="$(ls -1 "$PAGAN_ROOT/usr/lib/modules" 2>/dev/null | head -n1 || true)"
    if [[ -n "$_kver" ]]; then
        for _depmod in /usr/sbin/depmod /usr/bin/depmod /sbin/depmod; do
            if [[ -x "$PAGAN_ROOT$_depmod" ]]; then
                if pb_run "depmod -a $_kver" _c "$_depmod" -a "$_kver"; then
                    ok "depmod: $_kver (modules.dep odświeżony)"
                else
                    warn "depmod: $_kver – nie powiódł się"
                fi
                break
            fi
        done
    fi

    # ── Usługi: sieć, DNS, dźwięk (user), display manager ──────────────────
    # `systemctl enable` w chrocie działa (tworzy symlinki .wants).
    local svc
    local _svc_list="NetworkManager systemd-resolved systemd-timesyncd rtkit-daemon"
    [[ "${PAGAN_DE,,}" == "luna" ]] || _svc_list="$_svc_list lightdm"
    for svc in $_svc_list; do
        _c /usr/bin/systemctl enable "$svc" >>"$LOG_FILE" 2>&1 && ok "enable: $svc" \
            || warn "enable: $svc (jednostka może być w pakiecie z presetem)"
    done
    # Dźwięk to usługi UŻYTKOWNIKA – `--global` pisze do /etc/systemd/user.
    for svc in pipewire pipewire-pulse wireplumber; do
        _c /usr/bin/systemctl --global enable "$svc" >>"$LOG_FILE" 2>&1 \
            && ok "enable --global: $svc" || warn "enable --global: $svc (pominięte)"
    done
    # Domyślny cel graficzny.
    _c /usr/bin/systemctl set-default graphical.target >>"$LOG_FILE" 2>&1 \
        && ok "default target: graphical" || warn "set-default graphical – pominięte"

    _configure_luna

    # ── NVIDIA: modeset w jądrze (KMS) + brak czarnego ekranu ───────────────
    if (( ! NO_NVIDIA )); then
        mkdir -p "$PAGAN_ROOT/etc/modprobe.d"
        cat > "$PAGAN_ROOT/etc/modprobe.d/nvidia-pagan.conf" <<'EOF'
# Pagan Linux – NVIDIA: włącz KMS (nvidia-drm) i unikaj konfliktu z nouveau.
options nvidia_drm modeset=1 fbdev=1
options nvidia NVreg_PreserveVideoMemoryAllocations=1
blacklist nouveau
options nouveau modeset=0
EOF
        ok "NVIDIA: modprobe.d (nvidia_drm modeset=1, blacklist nouveau)"
    fi

    # ── GRUB: sensowne /etc/default/grub (instalator i tak wygeneruje cfg) ──
    mkdir -p "$PAGAN_ROOT/etc/default" "$PAGAN_ROOT/boot/grub"
    cat > "$PAGAN_ROOT/etc/default/grub" <<EOF
GRUB_DEFAULT=0
GRUB_TIMEOUT=5
GRUB_DISTRIBUTOR="${PAGAN_NAME}"
GRUB_CMDLINE_LINUX_DEFAULT="quiet splash"
GRUB_CMDLINE_LINUX=""
GRUB_PRELOAD_MODULES="part_gpt part_msdos"
GRUB_ENABLE_CRYPTODISK=y
EOF
    ok "GRUB: /etc/default/grub"

    # ── initramfs ──────────────────────────────────────────────────────────
    # Priorytet: initramfs buildera (obsługuje LIVE squashfs + root=UUID), bo
    # tylko on umie wystartować obraz live. Fallback: pagan-initramfs z repo.
    _phase_initramfs

    _umount_vfs
    _verify_audio_graphics
    ok "konfiguracja zakończona"
}

_phase_initramfs() {
    local kver
    kver="$(ls -1 "$PAGAN_ROOT/usr/lib/modules" 2>/dev/null | head -n1 || true)"
    [[ -n "$kver" ]] || { warn "brak /usr/lib/modules – initramfs pominięty"; return 0; }

    # 1) Spróbuj własnego initramfs buildera (obsługa pagan.live + root=).
    if [[ -x "$PAGAN_ROOT/usr/bin/pagan-initramfs" ]]; then
        if pb_run "initramfs: pagan-initramfs ($kver)" _c /usr/bin/pagan-initramfs "$kver"; then
            ok "initramfs: pagan-initramfs ($kver) – per wersja jądra"
        else
            warn "pagan-initramfs zgłosił problem – próbuję dalej"
            pb_tail 8
        fi
    else
        _log "  … pagan-initramfs jeszcze nie ma w rootfs (doinstaluję go w fazie pakowania)"
    fi

    # 2) Ustal plik initramfs dla ISO: /boot/initramfs.img (takiego szuka create_iso).
    if [[ ! -e "$PAGAN_ROOT/boot/initramfs.img" ]]; then
        local src
        src="$(ls -1 "$PAGAN_ROOT"/boot/initramfs-*.img "$PAGAN_ROOT"/boot/initrd* 2>/dev/null | head -n1 || true)"
        if [[ -n "$src" ]]; then
            cp -f "$src" "$PAGAN_ROOT/boot/initramfs.img"
            ok "initramfs: /boot/initramfs.img (z $(basename "$src"))"
        else
            _log "  … brak initramfs-$kver w /boot – zbuduje go build_initramfs w fazie pakowania"
        fi
    fi

    # 3) Symlink vmlinuz-linux (create_iso szuka tego pliku).
    if [[ ! -e "$PAGAN_ROOT/boot/vmlinuz-linux" ]]; then
        local vk
        vk="$(ls -1 "$PAGAN_ROOT"/boot/vmlinuz-* 2>/dev/null | head -n1 || true)"
        [[ -n "$vk" ]] && ln -sf "/boot/$(basename "$vk")" "$PAGAN_ROOT/boot/vmlinuz-linux"
    fi
}

# ========================= BRANDING (tapety, logo, neofetch, GRUB, pagan-wifi) =========================
# Branding bierzemy z lokalnego katalogu branding/ (to samo źródło co stary
# builder), więc obraz ma identyczny wygląd: dwie tapety, logo LOKI, grafikę
# neofetcha, splash GRUB-a oraz asystenta Wi-Fi.
_phase_branding() {
    pb_phase "BRANDING" "tapety, logo LOKI, neofetch, splash GRUB, pagan-wifi"
    local b="$SCRIPT_DIR/branding"
    [[ -d "$b" ]] || { warn "brak katalogu branding/ – pomijam"; return 0; }

    # ── Tapety (dwie) → /usr/share/wallpapers/paganlinux ───────────────────
    local wdir="$PAGAN_ROOT/usr/share/wallpapers/paganlinux"
    mkdir -p "$wdir"
    local w n=0
    for w in paganlinux.png pagannoc.png pagan-loki-pingwin.png; do
        [[ -f "$b/$w" ]] || continue
        install -m644 "$b/$w" "$wdir/$w"
        n=$((n+1))
    done
    [[ $n -gt 0 ]] && ok "tapety → $wdir ($n plików)" || true
    cat > "$wdir/metadata.json" <<EOF
{
    "KPlugin": {
        "Id": "paganlinux",
        "Name": "${PAGAN_NAME}",
        "Description": "Tapety ${PAGAN_NAME} (dzień/noc/LOKI)"
    }
}
EOF

    # ── Logo LOKI (ikony, pixmap) ─────────────────────────────────────────
    if [[ -f "$b/pagan-loki-pingwin.png" ]]; then
        install -Dm644 "$b/pagan-loki-pingwin.png" "$PAGAN_ROOT/usr/share/pixmaps/paganlinux.png"
        install -Dm644 "$b/pagan-loki-pingwin.png" \
            "$PAGAN_ROOT/usr/share/icons/hicolor/512x512/apps/paganlinux.png"
        ok "logo LOKI → /usr/share/pixmaps + hicolor"
    fi
    if [[ -f "$b/pagan-loki-pingwin.svg" ]]; then
        install -Dm644 "$b/pagan-loki-pingwin.svg" "$PAGAN_ROOT/usr/share/pixmaps/paganlinux.svg"
        install -Dm644 "$b/pagan-loki-pingwin.svg" \
            "$PAGAN_ROOT/usr/share/icons/hicolor/scalable/apps/paganlinux.svg"
    fi

    # ── neofetch: grafika LOKI zamiast pingwina Tuxa ───────────────────────
    if [[ -f "$b/neofetch/pagan" ]]; then
        local art="/usr/share/neofetch/ascii/distro/pagan"
        mkdir -p "$PAGAN_ROOT$(dirname "$art")"
        # Strip pustych linii na brzegach – inaczej grafika zsuwa się w dół.
        awk 'BEGIN{b=""} /^[[:space:]]*$/{if(s) b=b $0 "\n"; next} {s=1; printf "%s", b; b=""; print}' \
            "$b/neofetch/pagan" > "$PAGAN_ROOT$art"
        chmod 0644 "$PAGAN_ROOT$art"
        local cfg
        for cfg in "$PAGAN_ROOT/etc/skel/.config/neofetch/config.conf" \
                   "$PAGAN_ROOT/root/.config/neofetch/config.conf"; do
            mkdir -p "$(dirname "$cfg")"
            cat > "$cfg" <<NEOF
# ${PAGAN_NAME} – branding neofetch (grafika LOKI zamiast Tuxa).
image_backend="ascii"
image_source="$art"
NEOF
        done
        ok "neofetch: grafika + config (/etc/skel, /root)"
    fi

    # ── GRUB splash (używany przez menu ISO i przez grub-mkconfig) ─────────
    if [[ -f "$b/grub/paganlinux-grub.png" ]]; then
        install -Dm644 "$b/grub/paganlinux-grub.png" "$PAGAN_ROOT/boot/grub/splash.png"
        ok "GRUB splash → /boot/grub/splash.png"
    fi

    # ── pagan-wifi (asystent Wi-Fi na nmcli) + skrót w menu ────────────────
    if [[ -f "$b/pagan-wifi" ]]; then
        install -Dm755 "$b/pagan-wifi" "$PAGAN_ROOT/usr/bin/pagan-wifi"
        install -Dm644 /dev/stdin \
            "$PAGAN_ROOT/usr/share/applications/pagan-wifi.desktop" <<'DESK'
[Desktop Entry]
Type=Application
Name=Pagan Wi-Fi
Name[pl]=Pagan Wi-Fi
Comment=Połącz z siecią Wi-Fi (NetworkManager)
Comment[en]=Connect to a Wi-Fi network (NetworkManager)
Exec=xfce4-terminal -e "sudo /usr/bin/pagan-wifi"
Icon=network-wireless
Terminal=false
Categories=Network;Settings;
DESK
        ok "pagan-wifi → /usr/bin + skrót"
    fi

    # ── Domyślna tapeta XFCE (best-effort; dla /etc/skel i /root) ─────────
    local xfcfg
    for xfcfg in "$PAGAN_ROOT/etc/skel/.config/xfconf/xfce-perchannel-xml/xfce4-desktop.xml" \
                  "$PAGAN_ROOT/root/.config/xfconf/xfce-perchannel-xml/xfce4-desktop.xml"; do
        mkdir -p "$(dirname "$xfcfg")"
        cat > "$xfcfg" <<'XFCE'
<?xml version="1.0" encoding="UTF-8"?>
<channel name="xfce4-desktop" version="1.0">
  <property name="backdrop" type="empty">
    <property name="screen0" type="empty">
      <property name="monitor0" type="empty">
        <property name="workspace0" type="empty">
          <property name="last-image" type="string" value="/usr/share/wallpapers/paganlinux/paganlinux.png"/>
        </property>
      </property>
    </property>
  </property>
</channel>
XFCE
    done
    ok "domyślna tapeta XFCE (skel + root)"
}

# ========================= OS-RELEASE (rolling) =========================
_phase_release() {
    pb_phase "PLIKI WYDANIA (rolling)" "os-release, pagan-release, rejestracja pakietów w pag"
    local snap="${PAGAN_SNAPSHOT:-$(date -u +%Y.%m.%d)}"
    local id; id="$(printf '%s' "$snap" | tr -d '.')"
    local base="${PAGAN_VERSION%% *}"      # np. 1.0.0
    local ver="${base}.${id}"              # np. 1.0.0.20261006 (VERSION_ID)
    local label="${PAGAN_VERSION} ${snap}" # „1.0.0 Rolling 2026.10.06”

    cat > "$PAGAN_ROOT/etc/os-release" <<EOF
NAME="${PAGAN_NAME}"
VERSION="${label}"
VERSION_ID="${ver}"
ID=pagan
ID_LIKE=linux
VERSION_CODENAME=rolling
PRETTY_NAME="${PAGAN_NAME} ${label}"
ANSI_COLOR="1;32"
LOGO=paganlinux
HOME_URL="https://paganlinux.eu"
EOF
    cat > "$PAGAN_ROOT/etc/pagan-release" <<EOF
${PAGAN_NAME} ${PAGAN_VERSION}
Kanał: rolling (snapshot ${snap})
Środowisko: ${PAGAN_DE^^}
Data: $(date -u '+%Y-%m-%d %H:%M UTC')
Architektura: $(uname -m)
EOF
    ok "os-release: ${ver} (snapshot ${snap})"

    # Zarejestruj pakiety jako zarządzane przez pag → `pag upgrade` obejmie CAŁY
    # system (to jest sedno rolling: kolejne snapshoty podnoszą wersję z repo).
    _vfs_mount
    if [[ -s "$PAGAN_ROOT/usr/share/pag/base.json" ]]; then
        # Manifest zawiera CAŁE domknięcie bootstrapu. `pag base register`
        # pominie pakiety już w installed.json, a doda te z SYSTEM_BASE
        # (glibc, bash, coreutils, perl…), których resolver nie reinstaluje.
        if pb_run "pag base register" _c /usr/bin/pag base register; then
            ok "pag base register: pakiety z obrazu zarządzane przez pag"
        else
            warn "pag base register nieudane"
            pb_tail 8
        fi
    else
        warn "brak /usr/share/pag/base.json – pakiety bootstrapu mogą nie być widoczne dla pag upgrade"
    fi
    _umount_vfs
}

# ========================= GRUB: KOMPLETNE MODUŁY =========================
# Objaw: `grub-mkstandalone: /usr/lib/grub/x86_64-efi/modinfo.sh nie istnieje`
# i ISO bez boot EFI. Przyczyna: pakiet `grub` w repo bywał zbudowany
# niekompletnie – katalogi x86_64-efi/i386-efi zawierały tylko config.h.
#
# Doraźnie uzupełniamy moduły z HOSTA, jeśli wersja GRUB-a się zgadza (host
# i target to zwykle ten sam GRUB 2.14). Docelowo pakiet `grub` trzeba
# przebudować z aktualnej receptury i podbić pkgrel – wtedy ten import
# nie będzie potrzebny.
_grub_version() {
    # `grub-mkstandalone --version` zwraca np.:
    #   grub-mkstandalone (GRUB) 2.14
    #   /usr/bin/grub-mkstandalone (GRUB) 2.14     (w chrocie, bo $0 ma ścieżkę)
    # Porównujemy SAM numer wersji, nie całą linię – inaczej zawsze wychodziło
    # „wersje różne” i import modułów EFI był pomijany.
    sed -n 's/.*(GRUB)[[:space:]]*//p' | head -n1 | tr -d '[:space:]'
}

_ensure_grub_modules() {
    local arch src dst tv hv
    if ! declare -F create_iso >/dev/null 2>&1; then return 0; fi

    tv="$(chroot "$PAGAN_ROOT" /usr/bin/grub-mkstandalone --version 2>/dev/null | _grub_version)"
    hv="$(grub-mkstandalone --version 2>/dev/null | _grub_version)"
    if [[ -n "$tv" && -n "$hv" && "$tv" != "$hv" ]]; then
        warn "GRUB: wersja w obrazie ($tv) != host ($hv) – NIE importuję modułów"
        return 0
    fi
    [[ -n "$tv" ]] || warn "GRUB: nie wykryłem wersji w obrazie – importuję moduły hosta ($hv)"

    for arch in x86_64-efi i386-efi i386-pc; do
        src="/usr/lib/grub/$arch"
        dst="$PAGAN_ROOT/usr/lib/grub/$arch"
        [[ -d "$src" ]] || continue
        if [[ -e "$dst/modinfo.sh" ]] && compgen -G "$dst/*.mod" >/dev/null 2>&1; then
            continue
        fi
        warn "GRUB: $arch w obrazie niekompletny – importuję moduły z hosta"
        mkdir -p "$dst"
        if cp -a "$src/." "$dst/" >>"$LOG_FILE" 2>&1; then
            ok "GRUB: $arch uzupełniony z hosta ($(find "$dst" -maxdepth 1 -name '*.mod' | wc -l) modułów)"
        else
            warn "GRUB: import $arch z hosta nie powiódł się – boot $arch może nie działać"
        fi
    done

    if [[ ! -e "$PAGAN_ROOT/usr/lib/grub/x86_64-efi/modinfo.sh" ]]; then
        warn "GRUB: nadal brak x86_64-efi/modinfo.sh – ISO bez boot UEFI"
    elif ! compgen -G "$PAGAN_ROOT/usr/lib/grub/x86_64-efi/*.mod" >/dev/null 2>&1; then
        warn "GRUB: x86_64-efi bez modułów (*.mod) – ISO bez boot UEFI"
    else
        ok "GRUB: x86_64-efi kompletny ($(find "$PAGAN_ROOT/usr/lib/grub/x86_64-efi" -maxdepth 1 -name '*.mod' | wc -l) modułów)"
    fi
    return 0
}

# ========================= OBRAZY (reuse build-pagan.sh) =========================
# ========================= LUNA: sesja live =========================
# finalize_build pisze uniwersalny pagan-live.sh (startx). Dla Luny nadpisujemy
# go startem luna-session na tty1 (Wayland) + autostartem instalatora w live.
_luna_live_setup() {
    [[ "${PAGAN_DE,,}" == "luna" ]] || return 0

    mkdir -p "$PAGAN_ROOT/etc/profile.d"
    cat > "$PAGAN_ROOT/etc/profile.d/pagan-live.sh" <<'EOF'
# Autostart sesji live na tty1 (getty --autologin root).
# Luna to Wayland – bez startx; sekcja XFCE w finale buildera jest zastąpiona.
if [ "$(tty 2>/dev/null)" = "/dev/tty1" ] && [ -z "${WAYLAND_DISPLAY:-}${DISPLAY:-}" ]; then
    if ! command -v luna-session >/dev/null 2>&1; then
        echo "BŁĄD: brak luna-session – sesja live nie wystartuje" >&2
        return 0 2>/dev/null || true
    fi
    clear
    _pn="$(sed -n 's/^PRETTY_NAME=//p' /etc/os-release 2>/dev/null | tr -d '\"')"
    echo "${_pn:-Pagan Linux} – uruchamiam sesję Luna (Selene/Wayland)..."
    # Dźwięk dla roota: jednostki --user mają ConditionUser=!root.
    if [ -x /usr/bin/pagan-audio-setup ]; then
        /usr/bin/pagan-audio-setup >/tmp/pagan-audio.log 2>&1 &
    else
        command -v pipewire       >/dev/null 2>&1 && pipewire       >/tmp/pipewire.log       2>&1 &
        command -v pipewire-pulse >/dev/null 2>&1 && pipewire-pulse >/tmp/pipewire-pulse.log 2>&1 &
        command -v wireplumber    >/dev/null 2>&1 && wireplumber    >/tmp/wireplumber.log   2>&1 &
    fi
    exec /usr/bin/luna-session
fi
EOF
    chmod 755 "$PAGAN_ROOT/etc/profile.d/pagan-live.sh"

    # Instalator autostartuje TYLKO w live; na zainstalowanym systemie nie ma sensu.
    cat > "$PAGAN_ROOT/usr/bin/pagan-live-luna-installer" <<'EOF'
#!/bin/sh
if grep -qw 'pagan.live' /proc/cmdline 2>/dev/null || [ -d /run/live ]; then
    exec /usr/bin/luna-installer
fi
exit 0
EOF
    chmod 755 "$PAGAN_ROOT/usr/bin/pagan-live-luna-installer"

    mkdir -p "$PAGAN_ROOT/etc/xdg/autostart"
    cat > "$PAGAN_ROOT/etc/xdg/autostart/pagan-luna-installer.desktop" <<'EOF'
[Desktop Entry]
Type=Application
Name=Install Luna
Name[pl]=Zainstaluj Lunę
Exec=/usr/bin/pagan-live-luna-installer
Icon=system-software-install
Terminal=false
OnlyShowIn=Luna;
X-GNOME-Autostart-enabled=true
EOF
    mkdir -p "$PAGAN_ROOT/root/Desktop"
    cat > "$PAGAN_ROOT/root/Desktop/install-luna.desktop" <<'EOF'
[Desktop Entry]
Type=Application
Name=Install Luna
Name[pl]=Zainstaluj Lunę
Exec=/usr/bin/luna-installer
Icon=system-software-install
Terminal=false
Categories=System;
EOF
    chmod 755 "$PAGAN_ROOT/root/Desktop/install-luna.desktop" 2>/dev/null || true

    # finalize_build usuwa display-manager.service (aby live nie miał DM).
    # Dla Luny przywracamy go PO finale: greetd ma ConditionKernelCommandLine,
    # więc w live i tak nie wystartuje, a na dysku daje ekran logowania.
    mkdir -p "$PAGAN_ROOT/etc/systemd/system/graphical.target.wants"
    ln -sfn /usr/lib/systemd/system/greetd.service \
            "$PAGAN_ROOT/etc/systemd/system/graphical.target.wants/greetd.service"
    ln -sfn /usr/lib/systemd/system/greetd.service \
            "$PAGAN_ROOT/etc/systemd/system/display-manager.service"

    ok "Luna live: tty1 → luna-session, autostart instalatora"
}

_phase_pack() {
    local artdesc="ISO"
    case "$ARTIFACT" in
        img)  artdesc="IMG" ;;
        both) artdesc="ISO + IMG" ;;
    esac
    local _inst_desc="instalator TUI"
    [[ "${PAGAN_DE,,}" == "luna" ]] && _inst_desc="luna-installer + Luna live"
    pb_phase "PAKOWANIE OBRAZÓW" "finalize_build, pagan-initramfs (rolling), initramfs LIVE, ${_inst_desc}, ${artdesc}"
    export PAGAN_ROOT PAGAN_NAME PAGAN_FILE_PREFIX PAGAN_DE PAGAN_VERSION PAGAN_CHANNEL PAGAN_REPO_URL
    export OUTPUT_DIR PAGAN_CONFIG_FILE=/dev/null
    export PAGAN_JOBS="${PAGAN_JOBS:-$(nproc)}"
    # Bez Calamaresa: instalatorem jest własny `pagan-install` (TUI).
    export PAGAN_CALAMARES=0 PAGAN_FISH=0 PAGAN_SHELL=zsh

    case "$ARTIFACT" in
        iso)  export BUILD_ISO=1 BUILD_IMG=0 ;;
        img)  export BUILD_ISO=0 BUILD_IMG=1 ;;
        both) export BUILD_ISO=1 BUILD_IMG=1 ;;
    esac

    # Podmień $@ zanim source'ujemy buildera (jego top-level parsuje "$@").
    set --
    if [[ ! -f "$SCRIPT_DIR/build-pagan.sh" ]]; then
        die "Brak build-pagan.sh – potrzebny do pakowania obrazów (create_iso/create_image)."
    fi
    # shellcheck disable=SC1090,SC1091
    source "$SCRIPT_DIR/build-pagan.sh"

    # Stary builder instaluje własne trap ERR/EXIT. W v2 powodowało to m.in.
    # fałszywe „Build przerwany (kod 1)” po udanym ISO (gdy BUILD_IMG=0
    # kończyło _phase_pack statusem 1) i przejmowało cleanup. Wracamy do
    # trapów v2; _pb_cleanup woła funkcje sprzątające starego buildera.
    trap - ERR
    trap '_pb_cleanup' EXIT INT TERM

    [[ -d "$PAGAN_ROOT/usr" ]] || die "Rootfs niekompletny – nie mam czego pakować."
    declare -F create_iso >/dev/null || die "build-pagan.sh nie udostępnia create_iso()"

    # ── pagan-initramfs (rolling) ─────────────────────────────────────────
    # v2 instaluje jądro z repo, więc NIE woła install_rolling_kernel. Hook
    # post-install pakietu `kernel` przebudowuje initramfs przez pagan-initramfs,
    # więc narzędzie MUSI być w obrazie – inaczej po `pag upgrade kernel`
    # zostaje stary initramfs (albo brak) i system może nie wstać.
    if (( NO_INITRAMFS_TOOL )); then
        warn "pagan-initramfs: pominięte (--no-initramfs-tool)"
    elif declare -F install_initramfs_tool >/dev/null 2>&1; then
        pb_run_ok "pagan-initramfs (narzędzie rolling)" install_initramfs_tool || true
    else
        warn "build-pagan.sh nie udostępnia install_initramfs_tool() – rolling initramfs nie zadziała"
    fi

    # ── Instalator Pagan (WŁASNY, TUI) ───────────────────────────────
    # Calamares usunięty: instalatorem jest `pagan-install`. finalize_build
    # też go instaluje (idempotentnie), ale robimy to jawnie – _phase_pack
    # nie musi polegać na kolejności. Kopiuje binarkę + lib/ (locale/, data/).
    # Jednostka lightdm – starsze paczki jej nie miały. Piszemy tylko gdy brak.
    # Luna nie używa LightDM (ma greetd), więc nie dokładamy tej jednostki.
    if [[ "${PAGAN_DE,,}" != "luna" ]] \
       && declare -F _ensure_lightdm_units >/dev/null 2>&1 \
       && [[ ! -e "$PAGAN_ROOT/usr/lib/systemd/system/lightdm.service" ]]; then
        ( _ensure_lightdm_units ) >>"$LOG_FILE" 2>&1 && ok "lightdm: jednostka systemd" || true
    fi

    # instalator: pagan-install (binarka + lib/locale + data/groups.list + skrót).
    # Dla Luny instalatorem jest `luna-installer` z repo – pagan-install pomijamy.
    if [[ "${PAGAN_DE,,}" == "luna" ]]; then
        ok "instalator: luna-installer (z pakietu repo)"
    elif declare -F install_pagan_installer >/dev/null 2>&1; then
        if ( install_pagan_installer ) >>"$LOG_FILE" 2>&1; then
            ok "instalator: pagan-install (binarka + lib + skrót na pulpicie)"
        else
            warn "instalator: instalacja pagan-install nieudana (patrz $LOG_FILE)"
        fi
    else
        warn "build-pagan.sh nie udostępnia install_pagan_installer() – brak instalatora w obrazie"
    fi

    # Initramfs buildera (obsługuje pagan.live + squashfs ORAZ root=UUID/LUKS
    # dla systemu na dysku). Uruchamiam w PODPOWŁOCE: build_initramfs woła
    # wewnętrznie `error`, które kończy proces – w podpowłoce nie zabije to
    # naszego silnika. Dla IMG też go budujemy: obraz na dysku potrzebuje initrd.
    if (( BUILD_ISO || BUILD_IMG )) && declare -F build_initramfs >/dev/null 2>&1; then
        if ( build_initramfs ) >>"$LOG_FILE" 2>&1; then
            ok "initramfs (build_initramfs: live squashfs + root=UUID/LUKS)"
        else
            warn "build_initramfs nieudane – zostaje initramfs z pakietu (live może nie wstać)"
        fi
    fi

    # Kontrola stanu bootowania – konkretne pliki, a nie „chyba działa”.
    if [[ -s "$PAGAN_ROOT/boot/initramfs.img" ]]; then
        ok "initramfs: /boot/initramfs.img ($(du -Lh "$PAGAN_ROOT/boot/initramfs.img" | cut -f1))"
    else
        warn "BRAK /boot/initramfs.img – live/instalacja mogą nie wystartować"
    fi
    if [[ -x "$PAGAN_ROOT/usr/bin/pagan-initramfs" ]]; then
        ok "rolling: pagan-initramfs w obrazie (przebudowa po pag upgrade kernel)"
    else
        warn "rolling: brak pagan-initramfs – aktualizacja jądra nie przebuduje initramfs"
    fi

    # ── FINALIZACJA (jak w main() starego buildera, PRZED ISO) ──────────────
    # To ta sekwencja ustawia LIVE: autologin root na tty1 (getty@tty1),
    # /etc/profile.d/pagan-live.sh → startx, /root/.xinitrc → startxfce4,
    # pulpit XFCE z ikoną instalatora i tapetą, wyłączenie DM w live, jednostki
    # polkit/dbus/logind, politykę systemd-dbus i PAM. Bez tego live spada do
    # gołego TTY, a instalator nie ma settings.conf. finalize_build jest
    # idempotentne i w starym main() wołane best-effort (`|| warn`).
    if declare -F finalize_build >/dev/null 2>&1; then
        local _fin_desc="live: autologin tty1, pulpit XFCE, usługi"
        [[ "${PAGAN_DE,,}" == "luna" ]] && _fin_desc="live: autologin tty1, sesja Luna, usługi"
        ( set +e; set +u; finalize_build ) >>"$LOG_FILE" 2>&1 \
            && ok "finalize_build (${_fin_desc})" \
            || warn "finalize_build zgłosił problem (patrz $LOG_FILE)"
    fi

    # Luna: nadpisz pagan-live.sh (finalize pisze wariant startx) i dodaj
    # autostart instalatora tylko dla live.
    _luna_live_setup

    # Autostart SESJI (dźwięk + multi-monitor). finalize_build/_setup_xfce_live_desktop
    # tworzy te pliki dla live; instalator kopiuje rootfs, więc działają też na dysku.
    # Sprawdzamy jawnie – bez pagan-audio-setup root w live miałby ciszę
    # (jednostki PipeWire mają ConditionUser=!root).
    local _af
    if [[ "${PAGAN_DE,,}" == "luna" ]]; then
        # Luna nie używa xinitrc/autostartów XFCE: tty1 → luna-session,
        # dźwięk startuje z profilu live, a instalator z /etc/xdg/autostart.
        for _af in /usr/bin/luna-session /usr/bin/luna-installer \
                   /usr/bin/pagan-live-luna-installer \
                   /etc/xdg/autostart/pagan-luna-installer.desktop \
                   /usr/bin/luna-welcome; do
            if [[ -e "$PAGAN_ROOT$_af" ]]; then
                ok "Luna start: ${_af##*/}"
            else
                warn "Luna start: brak $_af"
            fi
        done
    else
        for _af in /usr/bin/pagan-audio-setup /etc/xdg/autostart/pagan-audio.desktop \
                   /usr/bin/pagan-display-setup /etc/xdg/autostart/pagan-display-setup.desktop; do
            if [[ -e "$PAGAN_ROOT$_af" ]]; then
                ok "autostart sesji: ${_af##*/}"
            else
                warn "autostart sesji: brak $_af (dźwięk/multi-monitor mogą nie wystartować)"
            fi
        done
    fi
    # Diagnostyka bez przerywania: wypisz uwagi weryfikacji do logu.
    if declare -F verify_rootfs >/dev/null 2>&1; then
        ( set +e; set +u; verify_rootfs ) >>"$LOG_FILE" 2>&1 \
            && ok "verify_rootfs: brak uwag" \
            || warn "verify_rootfs: są uwagi (szczegóły w $LOG_FILE)"
    fi

    # GRUB: uzupełnij moduły EFI, jeśli pakiet z repo jest niekompletny.
    _ensure_grub_modules || true

    if (( BUILD_ISO )); then create_iso; fi
    if (( BUILD_IMG )); then create_image; fi
    return 0
}

# ========================= PUBLIKACJA (opcjonalna) =========================
_phase_publish() {
    (( PUBLISH )) || return 0
    pb_phase "PUBLIKACJA PACZEK WYDANIA" "rsync paczek pagan-release/pagan-wallpapers do ${REMOTE:-?}"
    [[ -n "$REMOTE" ]] || die "--publish wymaga --remote user@vps:/ścieżka/repo"
    local stage="$SCRIPT_DIR/repo-out"
    mkdir -p "$stage"
    shopt -s nullglob
    local fresh=( "$OUTPUT_DIR/packages/pagan-release-"*.pag "$OUTPUT_DIR/packages/pagan-wallpapers-"*.pag )
    shopt -u nullglob
    if ((${#fresh[@]} == 0)); then
        warn "Brak świeżych .pag wydania w $OUTPUT_DIR/packages – nic nie wysyłam."
        return 0
    fi
    cp -av "${fresh[@]}" "$stage/"
    rsync -av --progress "$stage"/*.pag* "$REMOTE"/ \
        || die "rsync nie powiódł się"
    ok "Wysłane. NA VPS odśwież indeks: sudo pagsync --gen-repo --sign"
}

# ========================= MAIN =========================
pb_boot_status() {
    local kver="?" init="BRAK" ptool="brak" grub="brak" art="ISO"
    kver="$(ls -1 "$PAGAN_ROOT/usr/lib/modules" 2>/dev/null | head -n1 || echo '?')"
    [[ -s "$PAGAN_ROOT/boot/initramfs.img" ]] && init="tak"
    [[ -x "$PAGAN_ROOT/usr/bin/pagan-initramfs" ]] && ptool="tak"
    [[ -x "$PAGAN_ROOT/usr/bin/grub-mkconfig" || -x "$PAGAN_ROOT/usr/sbin/grub-mkconfig" ]] && grub="tak"
    case "$ARTIFACT" in img) art="IMG" ;; both) art="ISO + IMG" ;; esac

    _log ""
    _log "${C_B}▶ STAN BOOTOWANIA${C_0}"
    _log "   system:           ${PAGAN_NAME} ${PAGAN_VERSION}"
    _log "   artefakt:         ${art}"
    _log "   jądro:            ${kver} (pakiet kernel z repo – bez kompilacji w v2)"
    _log "   initramfs.img:    ${init}"
    _log "   pagan-initramfs:  ${ptool} (rolling po pag upgrade kernel)"
    _log "   grub-mkconfig:    ${grub}"
    local _disk_inst="pagan-install"
    [[ "${PAGAN_DE,,}" == "luna" ]] && _disk_inst="luna-installer"
    _log "   bootloader:       ISO=ISOLINUX+GRUB EFI, IMG=grub-install, dysk=${_disk_inst}"
    _log "   dźwięk:           PipeWire+WirePlumber (autostart pagan-audio-setup)"
    _log "   grafika:          KMS+Mesa+Xorg, NVIDIA przez nvidia-drm"
}

main() {
    _validate_identity
    _validate_root
    _log "═══ ${PAGAN_NAME} v2 – silnik budowania (rolling, z repo PAG) ═══"
    _log "  system:   ${PAGAN_NAME} ${PAGAN_VERSION} / DE: ${PAGAN_DE^^}"
    _log "  repo:     ${PAGAN_REPO_URL}"
    _log "  rootfs:   ${PAGAN_ROOT}   artefakt: ${ARTIFACT}"
    _log "  cache:    ${WORK_DIR}"
    [[ -n "${BUILD_LOCATION_NOTE:-}" ]] && warn "${BUILD_LOCATION_NOTE}"
    _log "  log:      ${LOG_FILE}"
    _log "  start:    $(date '+%Y-%m-%d %H:%M:%S')  •  PID $$"

    if (( CHECK )); then
        PB_PHASE_TOTAL=3
    else
        PB_PHASE_TOTAL=9
        (( SKIP_BOOTSTRAP )) && PB_PHASE_TOTAL=$(( PB_PHASE_TOTAL - 1 ))
        (( PUBLISH )) && PB_PHASE_TOTAL=$(( PB_PHASE_TOTAL + 1 ))
    fi

    _phase_host_deps
    _phase_index

    if (( CHECK )); then
        _phase_check || die "--check: są braki (patrz wyżej)"
        _log "  OK – można budować: sudo $0 ${PAGAN_DE} ${ARTIFACT}"
        exit 0
    fi

    if (( SKIP_BOOTSTRAP )); then
        pb_phase "ROOTFS (--reuse-rootfs)" "pomijam bootstrap i używam istniejącego ${PAGAN_ROOT}"
        _vfs_mount
        _c /usr/bin/pag --version >/dev/null 2>&1 \
            || die "W $PAGAN_ROOT nie ma działającego paga – bez --reuse-rootfs zrobiłbym bootstrap."
        _umount_vfs
    else
        _prepare_rootfs_skeleton
        _phase_bootstrap
    fi

    _phase_install_stack
    _phase_configure
    _phase_branding
    _phase_release
    _phase_pack
    _phase_publish

    pb_boot_status
    _log ""
    _log "═══ GOTOWE ═══  (czas całości: $(pb_elapsed))"
    ls -1t "$OUTPUT_DIR"/"${PAGAN_FILE_PREFIX}"-"${PAGAN_VERSION// /-}"-*.iso \
           "$OUTPUT_DIR"/"${PAGAN_FILE_PREFIX}"-*.iso "$OUTPUT_DIR"/"${PAGAN_FILE_PREFIX}"-*.img 2>/dev/null | head -n4 || true
    _log "Plan i wyjaśnienie GRUB/initramfs/jądra: sudo $0 --plan"
    _log "Rolling: pag upgrade (kernel → hook → pagan-initramfs + pag grub-update)"
    _log "Publikacja: --publish --remote …, a na VPS: pagsync --gen-repo --sign"
}

main "$@"