hammer/scripts/cosmic/metal-desktop-image.sh

#!/usr/bin/env bash
# metal-desktop-image.sh — imagen de disco EFI del escritorio COSMIC para METAL REAL, con
# **aceleración de hardware Intel (iris)**. Hermano de scripts/kde/metal-desktop-image-dual.sh, pero
# con una diferencia de fondo que es el motivo de existir.
#
# ── POR QUÉ ESTA IMAGEN ES HW-ACCEL Y LA DE KDE ES SOFTWARE ─────────────────────────────────────
# La de KDE va por `mesa-llvmpipe` a propósito: tenía que aguantar DOS máquinas (Intel y una NVIDIA
# Pascal) y la mesa HW de nouveau sólo existe como binario Alpine, o sea rompiendo soberanía.
#
# Acá el objetivo es otro y por eso la decisión se invierte: **cerrar el frente de ScreenCast**. El
# diagnóstico del 2026-08-05 (ver el runbook) midió que la cadena entera del portal funciona —el nodo
# `cosmic-screencast` existe en el grafo de pipewire— y que lo que falla es el COMPOSITOR en una
# llamada EGL, 8 ms antes de que el stream quede en `Paused`, porque en QEMU mesa es `kms_swrast`:
# software, **sin exportación dmabuf**. Un stream de vídeo continuo la necesita; una captura de una
# sola toma no (por eso `cosmic-screenshot` sí anda, va por shm).
#
# El `mesa` del corpus se construye con `-Dgallium-drivers=iris` y **ya está en el rootfs de COSMIC**
# (`usr/lib/dri/iris_dri.so`). En QEMU nunca se usaba; en un TigerLake es el driver correcto y trae
# dmabuf de verdad. O sea que este viaje no es «lo mismo pero en metal»: es la única forma de saber si
# ScreenCast está bien.
#
# ⚠ POR ESO NO SE INYECTA llvmpipe ACÁ. Mezclarlos no es aditivo: llvmpipe trae su propio
# `libgbm`/`libEGL`/`libgallium` y sobrescribirlos DESACTIVA iris. Si esta máquina no tuviera Intel,
# la imagen correcta sería la de KDE, no ésta con un parche.
#
# ── LO QUE **NO** HACE FALTA INYECTAR, Y ES MEDIBLE ─────────────────────────────────────────────
# La imagen de KDE inyecta `libLLVM.so.18`, `libgcc_s.so.1` y `libstdc++.so.6` porque el JIT de
# llvmpipe los NEEDea. Acá NO: `iris_dri.so` pide sólo `libglapi`, `libdrm`, `libz`, `libzstd` y
# `libc` —mesa va con `-Dllvm=disabled`— y `cosmic-comp` sólo `libdisplay-info`, `libgbm`, `libseat`,
# `libudev`, `libinput`, `libpixman`, `libxkbcommon` y `libc`. **Cero C++ y cero libgcc**: la imagen
# COSMIC de metal no arrastra un solo binario ajeno de Alpine. Verificado con clausura ELF completa
# del rootfs: 42 raíces de runtime, 0 con NEEDED sin proveedor.
#
#   work/metal-rootfs    base: arje-zero PID1 + busybox + firmware i915 (estática ⇒ inyectar musl)
#   work/cosmic-rootfs   COSMIC runtime-completo (89 recetas: compositor, apps, portal, pipewire,
#                        wireplumber, portal-probe) — ya trae iris_dri.so
#   + kernel linux-metal-dual   (i915 builtin)
#   → work/hammer-cosmic-metal.img
#
# Uso:  scripts/cosmic/metal-desktop-image.sh
set -euo pipefail
ROOT="$(cd "$(dirname "$0")/../.." && pwd)"; cd "$ROOT"

BASE="${BASE:-work/metal-rootfs}"
COSMIC="${COSMIC:-work/cosmic-rootfs}"
KERNEL="${KERNEL:-$(ls -dt store/*-linux-metal-dual/boot/bzImage 2>/dev/null | head -1)}"
MERGED="${MERGED:-work/cosmic-metal-rootfs}"
IMG="${IMG:-work/hammer-cosmic-metal.img}"

for x in "$BASE" "$COSMIC"; do [ -d "$x" ] || { echo "falta $x (corré scripts/cosmic/hydrate-cosmic.sh)" >&2; exit 1; }; done
[ -n "$KERNEL" ] && [ -r "$KERNEL" ] || { echo "falta linux-metal-dual (hammer build recipes/linux-metal-dual.toml)" >&2; exit 1; }

echo "==> fundiendo rootfs por hardlinks (base metal + COSMIC)"
rm -rf "$MERGED"
cp -al "$BASE" "$MERGED"
cp -al --remove-destination "$COSMIC"/. "$MERGED"/

. "$ROOT/scripts/lib/pid1-desde-store.sh"
inyectar_pid1 "$MERGED" "$BASE"

# El driver HW tiene que estar SÍ O SÍ: si no está, esta imagen no tiene razón de ser y es mejor
# fallar acá que descubrirlo con el USB en la mano frente a una pantalla negra.
[ -r "$MERGED/usr/lib/dri/iris_dri.so" ] || { echo "   ✗ falta iris_dri.so — sin GPU Intel esta imagen no sirve" >&2; exit 1; }
echo "==> GL por HARDWARE: $(ls "$MERGED"/usr/lib/dri/ | tr '\n' ' ')"

echo "==> inyectando musl (loader + libc) — COSMIC es dinámico, la base metal es estática"
MUSL="${MUSL:-/usr/lib/musl/lib/libc.so}"
[ -r "$MUSL" ] || { echo "no encuentro musl libc ($MUSL)" >&2; exit 1; }
mkdir -p "$MERGED/usr/lib/musl/lib" "$MERGED/lib"
cp -a "$MUSL" "$MERGED/usr/lib/musl/lib/libc.so"
ln -sf /usr/lib/musl/lib/libc.so "$MERGED/lib/ld-musl-x86_64.so.1"
ln -sf /usr/lib/musl/lib/libc.so "$MERGED/usr/lib/libc.so"
ln -sf /usr/lib/musl/lib/libc.so "$MERGED/usr/lib/libc.musl-x86_64.so.1"

# ── LA PREPARACIÓN DE SESIÓN QUE ESTA IMAGEN NO TENÍA ───────────────────────────────────────────
# Todo lo que sigue existía sólo en qemu-desktop-image.sh. La imagen de metal se armó copiando el
# arranque pero NO esta parte, y el resultado es que el escritorio no podía funcionar en metal por
# razones que nada tienen que ver con la GPU: sin `video` no arranca seatd, sin `messagebus` no
# arranca el bus de SISTEMA — y sin bus de sistema NO HAY PORTAL, o sea que `portal-probe screencast`
# no habría tenido con quién hablar aunque el GL fuese perfecto. Se descubrió corriendo `cosmic-start`
# sobre la imagen de metal por primera vez (antes sólo se validaba que llegara al prompt).
echo "==> inyectando arje-logind-compat (el login1 del fractal) + su política"
if ALC="${ALC:-store/$(./target/release/hammer --store store hash recipes/arje-logind-compat.toml 2>/dev/null | tail -1 | sed 's/^b3://')-arje-logind-compat}"; [ -d "$ALC" ]; then
  install -Dm755 "$ALC"/usr/bin/arje-logind-compat "$MERGED"/usr/bin/arje-logind-compat
  install -d "$MERGED/usr/share/dbus-1/system.d"
  cp -a --remove-destination "$ALC"/usr/share/dbus-1/system.d/. "$MERGED"/usr/share/dbus-1/system.d/ 2>/dev/null || true
  echo "   ✓ $(basename "$ALC" | cut -c1-12)"
else
  echo "   ✗ falta arje-logind-compat en store/ — cosmic-comp no hallará sesión" >&2; exit 1
fi
[ -f "$MERGED/usr/share/dbus-1/system.d/org.freedesktop.login1.conf" ] \
  || { echo "   ✗ falta org.freedesktop.login1.conf — re-sellá arje-logind-compat" >&2; exit 1; }

echo "==> grupo video (seatd lo exige por NOMBRE) y usuario messagebus (el bus de sistema hace setuid)"
if ! grep -q '^video:' "$MERGED/etc/group" 2>/dev/null; then
  { cat "$MERGED/etc/group" 2>/dev/null; echo "video:x:44:"; } > "$MERGED/etc/group.new"
  chmod 644 "$MERGED/etc/group.new"; mv "$MERGED/etc/group.new" "$MERGED/etc/group"
fi
for f in passwd:messagebus:x:81:81:messagebus:/dev/null:/sbin/nologin group:messagebus:x:81:; do
  file="${f%%:*}"; line="${f#*:}"
  if ! grep -q '^messagebus:' "$MERGED/etc/$file" 2>/dev/null; then
    { cat "$MERGED/etc/$file" 2>/dev/null; echo "$line"; } > "$MERGED/etc/$file.new"
    chmod 644 "$MERGED/etc/$file.new"; mv "$MERGED/etc/$file.new" "$MERGED/etc/$file"
  fi
done
for h in usr/libexec/dbus-daemon-launch-helper usr/lib/dbus-1.0/dbus-daemon-launch-helper; do
  [ -f "$MERGED/$h" ] && { chown 0:81 "$MERGED/$h" 2>/dev/null || true; chmod 4750 "$MERGED/$h"; }
done
grep -q '^video:' "$MERGED/etc/group" && grep -q '^messagebus:' "$MERGED/etc/passwd" \
  || { echo "   ✗ video/messagebus no quedaron en /etc — seatd y dbus fallarían" >&2; exit 1; }
echo "   ✓ video + messagebus"

# arje-logind-compat busca el bus de sistema en la ruta LEGACY /var/run y dbus-daemon escucha en /run.
# Esta base metal es tan mínima que ni siquiera tiene /var/run: sin el enlace, el daemon se va a idle
# y nunca registra login1.
ln -sfn /run "$MERGED/var/run"
printf 'COSMIC_MODE=%s\n' "${COSMIC_MODE:-bare}" > "$MERGED/etc/cosmic-mode"

# ── el arranque del escritorio ──────────────────────────────────────────────────────────────────
# Se instala EL MISMO script que corre en QEMU. Eso es deseable —hace que «validado en QEMU»
# signifique algo para el metal— pero SÓLO si el script no tiene supuestos del emulador escondidos.
#
# ⚠ ACÁ HABÍA UN COMENTARIO QUE AFIRMABA QUE NO LOS TENÍA, Y ERA FALSO. El script exportaba
# `LIBGL_ALWAYS_SOFTWARE=1` y `MESA_LOADER_DRIVER_OVERRIDE=kms_swrast` incondicionalmente, que es
# correcto sobre virtio-gpu y letal sobre un Intel real: la mesa del corpus es `iris` y no existe
# ningún `kms_swrast_dri.so` que cargar ⇒ EGL falla y el compositor no arranca. Costó un viaje
# físico el 2026-08-05. Ahora el script DETECTA el modo de GL, y esta imagen lo verifica abajo.
echo "==> instalando /usr/bin/cosmic-start (detecta HW/software; ya no fuerza kms_swrast)"
install -Dm755 scripts/cosmic/cosmic-start.sh "$MERGED/usr/bin/cosmic-start"
grep -q "MESA_LOADER_DRIVER_OVERRIDE=kms_swrast$" "$MERGED/usr/bin/cosmic-start" && {
    echo "   ✗ cosmic-start todavía fuerza kms_swrast incondicionalmente — esta imagen sería inútil" >&2; exit 1; }

# ── firmware i915 para OTRAS generaciones Intel, no sólo la del laptop ───────────────────────────
# La base metal trae sólo `tgl_*` (TigerLake). En el Coffee Lake del OptiPlex 3060 el kernel pidió
# `i915/kbl_dmc_ver1_04.bin` y no estaba. NO es fatal —el propio kernel dice «Disabling runtime power
# management» y sigue haciendo modeset— pero es gratis arreglarlo y evita perseguir un fantasma.
FWSRC="${FWSRC:-/usr/lib/firmware/i915}"
if [ -d "$FWSRC" ]; then
    n=0
    for f in "$FWSRC"/{kbl,skl,cfl,icl,ehl,jsl,adl,dg}*.bin*; do
        [ -r "$f" ] || continue
        b="$(basename "$f")"
        case "$b" in
            *.zst) zstd -qdf "$f" -o "$MERGED/lib/firmware/i915/${b%.zst}" 2>/dev/null && n=$((n+1)) ;;
            *)     cp -a "$f" "$MERGED/lib/firmware/i915/" && n=$((n+1)) ;;
        esac
    done
    echo "==> firmware i915: +$n blobs de otras generaciones (la base sólo traía tgl_*)"
else
    echo "   ⚠ sin $FWSRC — la imagen sólo servirá plenamente en TigerLake"
fi

# ── SSH: la puerta trasera que convierte un viaje físico en una sesión remota ────────────────────
# sshd ya arrancaba y escuchaba en :22, pero era INALCANZABLE: `PasswordAuthentication no` y sin
# /root/.ssh/authorized_keys. O sea que en metal sólo quedaba depurar a ciegas sobre la pantalla.
# Con una clave horneada, el próximo fallo se mira por red y se itera sin quemar el USB de nuevo.
AKEY="${AKEY:-work/metal-authorized_keys}"
if [ -r "$AKEY" ]; then
    install -Dm600 "$AKEY" "$MERGED/root/.ssh/authorized_keys"
    chmod 700 "$MERGED/root/.ssh"
    echo "==> SSH: authorized_keys horneada ($(wc -l < "$AKEY") clave/s) — root por clave, sin password"
else
    echo "   ⚠ sin $AKEY ⇒ sshd escuchará pero será inalcanzable (depuración sólo a ciegas)"
fi

# ── getty en tty1: el prompt TIENE que salir por la PANTALLA ────────────────────────────────────
# Lección del 1er viaje físico de KDE, que costó un USB quemado: el CMDLINE horneado es
# `console=tty0 console=ttyS0,115200 …` y el kernel hace /dev/console = la ÚLTIMA `console=` ⇒ ttyS0.
# La seed card de la base supervisa un solo getty, sobre `console` ⇒ en un metal sin puerto serie el
# shell nace INVISIBLE: la pantalla se congela en el último printk y parece que el arranque murió,
# cuando está vivo. Nunca se vio en QEMU porque siempre se validaba con `-nographic`, donde el serial
# ES la pantalla.
#
# Se arregla acá y no en el cmdline: un getty sobre tty1 no depende del cmdline (en metal siempre hay
# VT) y no obliga a re-sellar el kernel. El getty de `console` se conserva para debug por serie.
echo '==> añadiendo getty en tty1 (el prompt de `console` va al SERIAL, invisible en metal)'
cat > "$MERGED/usr/bin/console-login" <<'LOGIN'
#!/bin/sh
# arje-zero lanza los getty con envp VACÍO ⇒ sin PATH no se resuelve ni `cat` ni `cosmic-start`.
export PATH=/usr/bin:/bin:/usr/sbin:/sbin
export HOME=/root TERM=linux
[ -r /etc/motd ] && /bin/busybox cat /etc/motd
exec /bin/sh
LOGIN
chmod 0755 "$MERGED/usr/bin/console-login"

# ── netup pedía DHCP antes de que existiera el enlace ────────────────────────────────────────────
# Medido en el dmesg del OptiPlex 3060: el r8169 levanta el enlace a los 20,2 s (con downshift a
# 100 Mbps), y el ente sshd corría `netup` a los 13,7 s ⇒ DHCP sobre un cable que aún no estaba y
# «sin respuesta DHCP» para siempre, sin reintento. En QEMU no se ve: el virtio-net tiene carrier
# desde el instante cero. Sin red no hay SSH, y sin SSH el metal se depura a ciegas.
cat > "$MERGED/usr/bin/netup-wait" <<'NETUP'
#!/bin/sh
export PATH=/usr/bin:/bin:/usr/sbin:/sbin
i=0
while [ $i -lt 40 ]; do
    for c in /sys/class/net/*/carrier; do
        case "$c" in */lo/*) continue ;; esac      # lo siempre dice 1: no es señal de nada
        [ -r "$c" ] || continue
        [ "$(cat "$c" 2>/dev/null)" = 1 ] && exec /usr/bin/netup
    done
    i=$((i + 1)); sleep 1
done
echo "netup-wait: ninguna interfaz con carrier tras ${i}s — pido DHCP igual"
exec /usr/bin/netup
NETUP
chmod 0755 "$MERGED/usr/bin/netup-wait"

python3 - "$MERGED/ente/seed.card.json" <<'PY'
# OJO: $MERGED es un árbol de HARDLINKS a la base metal ⇒ escribir in-place mutaría también
# work/metal-rootfs (y toda otra imagen que comparta el inodo). Se escribe a un temporal y se
# os.replace ⇒ se reemplaza la ENTRADA de directorio, el inodo compartido queda intacto.
import json, sys, copy, os
p = sys.argv[1]
card = json.load(open(p))
gen = card["genesis"]
gen[:] = [g for g in gen if g["label"] != "tty1-getty"]          # idempotente
base = next(g for g in gen if g["label"] == "console-getty")
tty1 = copy.deepcopy(base)
tty1["id"] = "01HQAR53D4M2NBV8KZTYXFQA04"
tty1["label"] = "tty1-getty"
tty1["payload"]["Native"]["argv"] = ["getty", "-n", "-l", "/usr/bin/console-login", "38400", "tty1"]
gen.append(tty1)
# el ente sshd espera al carrier antes de pedir DHCP (ver netup-wait); idempotente
for g in gen:
    if g["label"] == "sshd":
        a = g["payload"]["Native"]["argv"]
        a[:] = [x.replace("/usr/bin/netup;", "/usr/bin/netup-wait;") for x in a]
json.dump(card, open(p + ".new", "w"), indent=2, sort_keys=True)
os.replace(p + ".new", p)
print("   ✓ genesis: " + ", ".join(g["label"] for g in gen))
PY

# `rm -f` antes del heredoc para ROMPER EL HARDLINK: `cat >` escribiría el inodo COMPARTIDO con
# work/metal-rootfs y le cambiaría el motd a todas las demás imágenes.
rm -f "$MERGED/etc/motd"
cat > "$MERGED/etc/motd" <<'MOTD'

  #-- hammer :: escritorio COSMIC (metal, Intel i915 + iris HW) ---------------
   GL por HARDWARE (iris). Es la diferencia con la imagen de KDE, y el motivo
   de este viaje: en QEMU mesa era software y ScreenCast no podía exportar
   dmabuf.

   Arrancar el escritorio:   cosmic-start
     ⇒ tiene que decir "GL por HARDWARE". Si dice SOFTWARE, el viaje no
       sirve: ScreenCast fallaría igual que en QEMU.
   Probar el portal:         portal-probe version
                             portal-probe screencast     <-- LO QUE VINIMOS A VER
   GPU detectada:            ls /dev/dri ; dmesg | grep -iE 'i915|drm'
   Logs (en DISCO, sobreviven al apagón):   /var/log/cosmic/
   Red y SSH:                netup-wait ; ip addr     (root por clave, sin password)
  ---------------------------------------------------------------------------

MOTD

mkdir -p "$MERGED/root/.config" "$MERGED/root/.cache" "$MERGED/run/user/0" "$MERGED/tmp"
chmod 1777 "$MERGED/tmp"

echo "==> rootfs fundido: $(du -sh "$MERGED" | cut -f1)"
need_mb=$(du -sm "$MERGED" | cut -f1)
ROOT_SIZE="${ROOT_SIZE:-$(( need_mb + 1536 ))}"
echo "==> ROOT_SIZE=${ROOT_SIZE} MiB · kernel: $(basename "$(dirname "$(dirname "$KERNEL")")")"

export ROOTFS="$MERGED" IMG ROOT_SIZE KERNEL
export ESP_MB="${ESP_MB:-160}" STORE_SIZE="${STORE_SIZE:-512}" STATE_SIZE="${STATE_SIZE:-768}"
exec ./scripts/install-image-efi.sh