#!/bin/sh
# takana-install-partition.sh — instalar takana EN UNA PARTICIÓN, sin tocar la tabla ni las vecinas.
#
# ── QUÉ LO SEPARA DE LOS OTROS DOS INSTALADORES ────────────────────────────────────────────────
# `install-image-efi.sh` fabrica una IMAGEN de disco entera, y `takana-live-install.sh` reparticiona
# el DISCO entero (`o` en fdisk = tabla nueva). Los dos presuponen que el disco es nuestro. Éste
# presupone lo contrario: **el disco es de otro y takana llega de visita**.
#
#   - NO escribe la tabla de particiones. Ni una vez. No invoca fdisk/sfdisk/parted.
#     (La única excepción es `--use-free-space`, que AÑADE una entrada en un hueco sin asignar y no
#     modifica ninguna de las existentes. Se dice aparte porque es la única vez que la tabla cambia.)
#   - Formatea EXACTAMENTE una partición: la que se le nombra.
#   - Reusa la ESP que ya existe, y escribe sólo dentro de `\EFI\takana\` — la ruta de VENDOR, que
#     es nuestra. `\EFI\BOOT\BOOTX64.EFI` es tierra de nadie (Windows la repuebla) y **no se pisa**
#     si ya existe, salvo `--claim-fallback` explícito.
#   - Registra la entrada NVRAM propia (`takana boot entry add`, ADR 0018) tras hacer un `backup`
#     del estado de arranque. Convivir, no desplazar.
#
# ⚠ **Lo que este instalador NO hace, a propósito: redimensionar.** Encoger pide desmontar el
# filesystem (ext4 sólo crece online), y desmontar la partición donde estás corriendo no se puede.
# Eso es física, no una carencia del script: el redimensionado vive en el instalador que corre desde
# OTRO medio. Acá la partición destino tiene que existir y estar libre.
#
# Uso:
#   sudo scripts/takana-install-partition.sh --root-part /dev/nvme0n1p5 --esp /dev/nvme0n1p1
#   # prueba sin hardware (dos ficheros pre-dimensionados, sin root):
#   scripts/takana-install-partition.sh --root-part work/p-root.img --esp work/p-esp.img --no-nvram
#
# Opciones:
#   --root-part <dev|PARTUUID=…|UUID=…|LABEL=…>  DESTINO. Se formatea ext4 con LABEL=hammer-root.
#                              Lo ÚNICO destructivo. **Usá PARTUUID=**: los nombres nvmeXn1 NO son
#                              estables entre arranques (medido) y el kexec cambia quién enumera.
#   --survey                   mirar y NO tocar: el censo del terreno de esta máquina, con el
#                              PARTUUID de cada partición y qué se puede usar. Empezá por acá.
#   --json                     (con --survey) el mismo censo en JSON. Es el CONTRATO que consume
#                              una cara gráfica: `takana metal survey --json` lo envuelve.
#                              **Versión 2** desde el 2026-09-25: cada fila trae además `clase`,
#                              `disco`, `inicio_bytes`, `tamano_bytes` y `tipo_guid`, y hay un array
#                              `discos` con el aparato. Es lo que hace falta para DIBUJAR el terreno
#                              en vez de listarlo; nada de eso decide — `veredicto` y `usable`
#                              siguen siendo los únicos que deciden.
#                              ⚠ El JSON sale por stdout y SOLO el JSON: la línea de qué herramienta
#                              se resolvió del store va por stderr. Si algún día se cuela en stdout,
#                              la cara deja de parsear y el censo se lee como «no hay discos».
#   --pick <fichero>           mostrar el censo, DEJAR ELEGIR y NO TOCAR NADA: deja la elección en
#                              <fichero> (`DEST=…`, `FREE=1`, `DISK=…`) y sale. Es lo que permite
#                              decidir ANTES del salto — así lo de después no necesita pantalla.
#                              La respuesta va a un FICHERO y no a stdout porque stdout es donde
#                              sale el menú: mezclarlos obliga a quien lo llama a adivinar dónde
#                              termina la conversación y empieza el dato.
#   (sin destino)              modo INTERACTIVO: muestra el censo y te deja elegir. Es lo que hace
#                              que un mismo medio sirva en cualquier máquina.
#   --use-free-space           no formatear nada existente: crear la partición en el hueco sin
#                              asignar más grande de `--disk` e instalar ahí. Al lado, no encima.
#   --on-active-root <modo>    qué hacer si `--root-part` ES la raíz viva (auto|kexec|free-space|abort).
#                              `auto` (def) = intentar kexec y, si esta máquina no puede, espacio libre.
#   --esp <dev|fichero>        ESP existente a poblar (FAT). Sin ella no hay arranque.
#   --disk <dev> --esp-part N  para la entrada NVRAM; si no se dan, se deducen del `--esp`.
#   --claim-fallback           además, escribir \EFI\BOOT\BOOTX64.EFI (pisa lo que haya ahí).
#   --keep <dev|PARTUUID=…|UUID=…|LABEL=…>:<punto>
#                              CONSERVAR esa partición y montarla en <punto> en el sistema nuevo,
#                              SIN formatearla. Hoy el único <punto> admitido es `/home`. Los
#                              usuarios que encuentre ahí se crean en el sistema nuevo CON SU MISMO
#                              uid, y con el nombre del directorio como login. Se comprueba que
#                              monte ANTES de tocar la raíz: descubrir que el /home que se iba a
#                              conservar no monta, con la raíz ya formateada, es el peor momento.
#   --adopt                    NO FORMATEAR el destino: mover el sistema que ya hay ahí a
#                              `/sistema-anterior` y dejar su `/home` donde está. Es el caso más
#                              común de todos —una sola partición con un Linux y el /home adentro—
#                              y el que peor resuelve formatear: lo único irreponible de una
#                              máquina es el /home de quien la usa. Mover dentro del mismo
#                              filesystem es un `rename(2)`: no copia un byte. El sistema anterior
#                              queda ENTERO y accesible, que es mejor que un respaldo.
#                              Incompatible con `--use-free-space` (ahí no hay nada que adoptar).
#   --no-nvram                 no tocar la NVRAM (pruebas, o firmware que se registra a mano).
#   --yes                      no preguntar (para guiones; en interactivo pide confirmación).
# Variables: ROOTFS KERNEL BUSYBOX (como install-image-efi.sh) · STAGE (def work/.install-part-stage)
set -eu
ROOT="$(cd "$(dirname "$0")/.." && pwd)"; cd "$ROOT"

DEST=""; ESP=""; DISK=""; ESP_PART=""; CLAIM_FALLBACK=""; NO_NVRAM=""; ASSUME_YES=""
USE_FREE=""; ON_ACTIVE="${ON_ACTIVE:-auto}"; SOLO_CENSO=""; CENSO_JSON=""; SOLO_ELEGIR=""
KEEP_SPEC=""; KEEP_PUNTO=""; KEEP_DEV=""; KEEP_UUID=""; KEEP_PARTUUID=""; KEEP_DIR=""; KEEP_MONTE_YO=""
ADOPT=""; ADOPT_DIR=""; ADOPT_MONTE_YO=""; ADOPT_SUB=""; ADOPT_MUEVE=""
while [ $# -gt 0 ]; do
    case "$1" in
        --root-part) DEST="${2:?}"; shift 2 ;;
        --esp)       ESP="${2:?}";  shift 2 ;;
        --disk)      DISK="${2:?}"; shift 2 ;;
        --esp-part)  ESP_PART="${2:?}"; shift 2 ;;
        --claim-fallback) CLAIM_FALLBACK=1; shift ;;
        --no-nvram)  NO_NVRAM=1; shift ;;
        --survey)    SOLO_CENSO=1; shift ;;
        --json)      CENSO_JSON=1; shift ;;
        --pick)      SOLO_ELEGIR="${2:?--pick necesita el fichero donde dejar la respuesta}"; shift 2 ;;
        --use-free-space) USE_FREE=1; shift ;;
        --keep)      KEEP_SPEC="${2:?--keep necesita <dev|PARTUUID=…|UUID=…|LABEL=…>:<punto>}"; shift 2 ;;
        --adopt)     ADOPT=1; shift ;;
        --on-active-root) ON_ACTIVE="${2:?}"; shift 2 ;;
        --yes|-y)    ASSUME_YES=1; shift ;;
        -h|--help)   sed -n '2,40p' "$0"; exit 0 ;;
        *) echo "opción desconocida: $1 (--help)" >&2; exit 2 ;;
    esac
done
# Sin destino no se aborta: se PREGUNTA. Eso es lo que separa un instalador de un guion que hay que
# preparar por máquina. Sólo si tampoco hay con quién hablar (sin terminal) se pide el parámetro.
NECESITA_ELEGIR=""
if [ -z "$DEST" ] && [ -z "$USE_FREE" ] && [ -z "$SOLO_CENSO" ]; then NECESITA_ELEGIR=1; fi
case "$ON_ACTIVE" in auto|kexec|free-space|abort) ;; *) echo "--on-active-root: auto|kexec|free-space|abort" >&2; exit 2 ;; esac

# ── Las herramientas, ANTES que nada ───────────────────────────────────────────────────────────
# Se resuelven acá arriba y no junto a su uso porque `--use-free-space` necesita `sfdisk` durante
# las GUARDAS, o sea antes de tocar nada. Salen del store por hash vigente; `TOOL_<binario>=` las
# inyecta cuando no hay store (dentro del initramfs de un instalador, p. ej.).
. "$(dirname "$0")/lib/herramientas-desde-store.sh"
# Los dos caminos que conservan datos ajenos viven en sus propias librerías, y eso es lo que permite
# certificarlos SIN root (`scripts/adoptar-test.sh`): el instalador entero necesita losetup, mount y
# un disco; estas funciones, sobre directorios, se prueban enteras en un segundo.
. "$(dirname "$0")/lib/usuarios-del-home.sh"
. "$(dirname "$0")/lib/adoptar.sh"
# La cuenta de quien va a usar la máquina. Este camino —`--keep`/`--adopt`, el más común de todos—
# no preguntaba NADA: los usuarios salían del `/home` conservado con `!` en shadow y root quedaba
# cerrado, o sea una máquina instalada e inadministrable. Medido en metal el 2026-10-14.
. "$(dirname "$0")/lib/cuenta.sh"
SFDISK=$(herramienta util-linux sbin/sfdisk sfdisk) || exit 1
# `e2label` sólo hace falta para `--adopt`, que no formatea: ahí la etiqueta por la que el arranque
# encuentra la raíz hay que ponerla a mano. Se resuelve acá arriba —con el resto— y sólo cuando se
# pidió adoptar, para no exigir una herramienta que el camino normal no usa.
# ⚠ **Sin `|| exit 1`, y eso es el punto.** `e2label` es OPCIONAL: cuando no está, la etiqueta la
# escribe `takana fs-label`, que viaja en el mismo medio. Con el `|| exit 1` que tenía, el script se
# moría acá arriba —antes de tocar nada, sí, pero también antes de llegar al plan B— y la
# instalación entera fallaba con «falta e2label» sobre una máquina que podía perfectamente adoptar.
# Medido en QEMU el 2026-10-02. Una herramienta con alternativa no se exige: se busca.
E2LABEL=""
if [ -n "$ADOPT" ]; then
    E2LABEL=$(herramienta e2fsprogs sbin/e2label e2label 2>/dev/null || true)
fi
# Releer la tabla es su propio problema: tras añadir una entrada, el kernel NO se entera solo y el
# device nuevo no aparece. `partx -a` se lo dice; `blockdev --rereadpt` es el ioctl crudo, que falla
# si alguna partición del disco está montada — por eso se intentan los dos, en ese orden. Los dos
# salen del `util-linux` sellado: en el anfitrión musl no existe ninguno (ni `partprobe`).
PARTX=$(herramienta util-linux usr/sbin/partx partx 2>/dev/null || echo "")
BLOCKDEV=$(herramienta util-linux sbin/blockdev blockdev 2>/dev/null || echo "")
# ⚠ **MIRAR no puede costar lo mismo que ESCRIBIR.** Todo lo de abajo —los tres binarios de mtools,
# mke2fs y el bzImage— sólo hace falta para INSTALAR, y hasta el 2026-09-23 se exigía también para
# `--survey`: en una máquina ajena, sin store y sin kernel del corpus, el censo moría con «no
# encuentro el kernel EFI-stub» ANTES de imprimir una sola línea del terreno. Y el censo es
# justamente lo primero que se corre en una máquina desconocida, donde nada de eso existe todavía.
# El censo necesita `sfdisk` y `blkid`, nada más.
if [ -z "$SOLO_CENSO" ] && [ -z "$SOLO_ELEGIR" ]; then
    MKE2FS=$(herramienta e2fsprogs sbin/mke2fs mke2fs) || exit 1
    MMD=$(herramienta    mtools usr/bin/mmd   mmd)     || exit 1
    MCOPY=$(herramienta  mtools usr/bin/mcopy mcopy)   || exit 1
    MDIR=$(herramienta   mtools usr/bin/mdir  mdir)    || exit 1
    KERNEL="${KERNEL:-$(ls -dt store/*-linux-metal/boot/bzImage /store/*-linux-metal/boot/bzImage 2>/dev/null | head -1)}"
    [ -n "${KERNEL:-}" ] && [ -r "$KERNEL" ] || { echo "no encuentro el kernel EFI-stub (set KERNEL=)" >&2; exit 1; }
fi
HAMMER="${HAMMER:-$ROOT/target/release/takana}"

# ── LAS GUARDAS VAN PRIMERO, Y SON EL PUNTO DE ESTE SCRIPT ─────────────────────────────────────
# Un instalador que borra de más falla del lado silencioso: el usuario se entera cuando reinicia y
# le falta su /home. Cada guarda de abajo existe porque su ausencia es irreversible.
es_bloque() { [ -b "$1" ]; }
nombre_kernel() { basename "$(readlink -f "$1")"; }
disco_de() { echo "/dev/$(basename "$(readlink -f "/sys/class/block/$(nombre_kernel "$1")/..")")"; }

# ── resolver_dev <spec> — NUNCA confíes en `/dev/nvme1n1p6` ───────────────────────────────────
# ⚠ **Los nombres `nvmeXn1` NO son estables entre arranques, y esto está MEDIDO, no temido**
# (2026-09-23, QEMU con dos NVMe): el disco declarado primero en la línea de comandos apareció
# como `nvme1n1` y el segundo como `nvme0n1` — **cruzados**. Salen del orden de sondeo del bus, no
# del orden físico ni del que vos ves hoy con `lsblk`.
#
# Para un instalador eso no es una molestia: es la diferencia entre formatear la raíz vieja y
# formatear el disco de Windows del usuario. Y el salto por kexec lo agrava, porque el kernel que
# enumera después del salto NO es el que te dio los nombres antes.
#
# Por eso se acepta —y se recomienda— direccionar por identidad y no por posición:
#   PARTUUID=<uuid>   el de la TABLA GPT. **No cambia al formatear la partición**, así que es el
#                     correcto para nombrar un destino que se va a formatear.
#   UUID=<uuid>       el del FILESYSTEM. Sirve para identificar lo que hay HOY (y muere al formatear).
#   LABEL=<etiqueta>  cómodo, pero puede estar repetido en dos discos.
resolver_dev() {
    case "$1" in
        /dev/*) echo "$1"; return 0 ;;
        PARTUUID=*|partuuid=*) _rd_v="${1#*=}"; _rd_por=partuuid ;;
        UUID=*|uuid=*)         _rd_v="${1#*=}"; _rd_por=uuid ;;
        LABEL=*|label=*)       _rd_v="${1#*=}"; _rd_por=label ;;
        *) echo "$1"; return 0 ;;          # un fichero (pruebas)
    esac
    # `findfs` resuelve UUID y LABEL en busybox y en util-linux; para PARTUUID no se puede contar
    # con él, así que ese caso se resuelve leyendo la TABLA con sfdisk — que es donde vive el dato.
    if [ "$_rd_por" != partuuid ] && command -v findfs >/dev/null 2>&1; then
        _rd_d=$(findfs "$(printf '%s' "$_rd_por" | tr 'a-z' 'A-Z')=$_rd_v" 2>/dev/null || true)
        [ -n "${_rd_d:-}" ] && { echo "$_rd_d"; return 0; }
    fi
    # `/dev/loop?` está en la lista porque el banco de pruebas trabaja sobre loop devices: sin él,
    # la resolución por identidad quedaba SIN COBERTURA en el único sitio donde se puede probar sin
    # arriesgar un disco de verdad. Lo detectó el propio banco al pasar a PARTUUID.
    for _rd_disco in /dev/nvme?n? /dev/sd? /dev/vd? /dev/mmcblk? /dev/loop? /dev/loop??; do
        [ -b "$_rd_disco" ] || continue
        case "$_rd_por" in
            partuuid)
                _rd_hit=$("$SFDISK" -d "$_rd_disco" 2>/dev/null \
                    | awk -v u="$(printf '%s' "$_rd_v" | tr 'A-Z' 'a-z')" \
                        'tolower($0) ~ ("uuid=" u) {print $1; exit}')
                ;;
            *)
                _rd_hit=$(for _rd_p in "$_rd_disco"*; do
                    [ -b "$_rd_p" ] || continue
                    blkid "$_rd_p" 2>/dev/null | grep -qi "$(printf '%s' "$_rd_por" | tr 'a-z' 'A-Z')=\"$_rd_v\"" && { echo "$_rd_p"; break; }
                  done)
                ;;
        esac
        [ -n "${_rd_hit:-}" ] && { echo "$_rd_hit"; return 0; }
    done
    echo "takana-install-partition: no encuentro ninguna partición con $1" >&2
    echo "                          (mirá 'lsblk -o NAME,SIZE,PARTUUID,LABEL' en el sistema vivo)" >&2
    return 1
}

# ── releer_tabla <disco> — que el KERNEL se entere de la entrada nueva ────────────────────────
# Medido el 2026-09-23 en el banco: `sfdisk --append` escribió la entrada perfectamente y
# `/dev/loop0p4` NO APARECIÓ. El script lo detectó y abortó —bien— pero el motivo estaba fuera de
# él: en el anfitrión musl no existen `partprobe`, `partx` ni `blockdev`, así que los tres intentos
# de releer la tabla eran no-ops silenciosos. La tabla en disco y la que el kernel tiene en memoria
# son dos cosas distintas, y nada avisa cuando divergen.
# ⚠ Y el comando es `partx -u`, NO `partx -a`: medido en el banco el mismo día. `-a` («añadir»)
# intenta registrar TODAS las particiones y falla entero —«error adding partitions 1-4»— cuando las
# viejas ya están, que es siempre en este flujo. `-u` («actualizar») añade lo que falte y deja en paz
# lo que ya hay. El nombre de la opción sugiere justo lo contrario de lo que sirve acá.
releer_tabla() {
    [ -n "${PARTX:-}" ] && "$PARTX" -u "$1" >/dev/null 2>&1 && return 0
    [ -n "${PARTX:-}" ] && "$PARTX" -a "$1" >/dev/null 2>&1 && return 0
    [ -n "${BLOCKDEV:-}" ] && "$BLOCKDEV" --rereadpt "$1" >/dev/null 2>&1 && return 0
    partprobe "$1" 2>/dev/null || true
}

# ── EL CENSO DEL TERRENO ───────────────────────────────────────────────────────────────────────
# Un instalador que hay que preparar a mano para cada máquina no es un instalador. Esto enumera lo
# que hay —en CUALQUIER máquina— y dice de cada partición si se puede usar, si no se debe tocar y
# por qué. Es la base del modo interactivo y de la recomendación automática.
#
# Dos fuentes, porque ninguna sola alcanza:
#   · `sfdisk -d`  da el TIPO de la tabla (GUID) y el **PARTUUID**, que es la identidad estable;
#   · `blkid`      da lo que hay ADENTRO (ntfs, crypto_LUKS, ext4, swap…), que el tipo GPT miente
#                  a menudo: media instalación de Windows vive en «datos básicos», y un LUKS puede
#                  estar en una partición marcada como Linux.
# Y `/proc/mounts` dice qué está en uso AHORA, que es lo único que distingue «vacía» de «tu raíz».

# ── raiz_viva_majmin — quién es «/» de verdad ─────────────────────────────────────────────────
# ⚠ **`/proc/mounts` NO alcanza para saber cuál es la raíz viva, y esto está MEDIDO** (2026-09-23,
# sobre el anfitrión de este hub): la línea de «/» dice `/dev/root`, un nombre que no existe en
# `/dev` ni casa con ninguna partición. Comparar por nombre daba «ninguna partición es la raíz» y el
# censo **ofrecía formatear la raíz del sistema que estaba corriendo**. Pasa también con `UUID=…`
# en la cmdline, con initramfs que montan por label, y con `/dev/mapper/*`.
#
# Lo que sí es inequívoco es el NÚMERO de dispositivo: `stat` lo da para «/» y cada partición lo
# publica en `/sys/class/block/<n>/dev`. La descomposición es la de Linux (12 bits de major, minor
# partido en dos), no el `/256` ingenuo, que se rompe justo en NVMe (major 259).
raiz_viva_majmin() {
    _rv_hex=$(stat -c %D / 2>/dev/null) || return 1
    [ -n "${_rv_hex:-}" ] || return 1
    _rv_d=$(( 0x$_rv_hex )) 2>/dev/null || return 1
    _rv_maj=$(( (_rv_d >> 8) & 0xfff ))
    _rv_min=$(( (_rv_d & 0xff) | ((_rv_d >> 12) & 0xfff00) ))
    echo "${_rv_maj}:${_rv_min}"
}
RAIZ_MAJMIN="$(raiz_viva_majmin || true)"

es_la_raiz_viva() {   # <dev>
    [ -n "${RAIZ_MAJMIN:-}" ] || return 1
    _er_n=$(nombre_kernel "$1")
    [ "$(cat "/sys/class/block/$_er_n/dev" 2>/dev/null)" = "$RAIZ_MAJMIN" ]
}

GUID_ESP="c12a7328-f81f-11d2-ba4b-00a0c93ec93b"
GUID_MSR="e3c9e316-0b5c-4db8-817d-f92df00215ae"
GUID_WINRE="de94bba4-06d1-4d40-a16a-bfd50179d6ac"
GUID_MSBASIC="ebd0a0a2-b9e5-4433-87c0-68b6b72699c7"
GUID_LINUX="0fc63daf-8483-4772-8e79-3d69d8477de4"
GUID_LUKS="ca7d7ccb-63ed-4c53-861c-1742536059cc"
GUID_SWAP="0657fd6d-a4ab-43c4-84e5-0933c84b4f4f"

discos_del_sistema() {
    for _dd in /dev/nvme?n? /dev/sd? /dev/vd? /dev/mmcblk? /dev/loop? /dev/loop??; do
        [ -b "$_dd" ] || continue
        # Tamaño 0 = un `loop` libre sin fichero detrás. Existen por docenas y no son discos: si se
        # listan, el censo se llena de ruido y lo que importa deja de verse. Un guardián ruidoso se
        # ignora igual que uno mudo.
        [ "$(cat "/sys/class/block/$(basename "$(readlink -f "$_dd")")/size" 2>/dev/null || echo 0)" -gt 0 ] || continue
        echo "$_dd"
    done
}

mib_de_sectores() { echo $(( ${1:-0} / 2048 )); }
mib_de_bytes()    { echo $(( ${1:-0} / 1048576 )); }

# ── sector_bytes_de <disco> — el sector LÓGICO, que no siempre es 512 ──────────────────────────
# `sfdisk -d` cuenta en sectores LÓGICOS y lo declara en su cabecera (`sector-size: 512`). En un
# disco 4Kn eso son 4096, y dividir por 2048 a ciegas da un tamaño **ocho veces menor**: una
# partición de 40 G se muestra como 5 G y el piso de `mib_necesarios` la rechaza por chica — o sea
# que el error no se queda en la pantalla, **decide**.
#
# ⚠ Y no se puede unificar con `/sys/class/block/<n>/size`, que es lo que usa la rama del disco sin
# tabla: **ése siempre cuenta en unidades de 512**, por convención del kernel, incluso en 4Kn.
# Mezclar las dos conversiones es el error que esta separación evita.
sector_bytes_de() {
    _sb_v=$("$SFDISK" -d "$1" 2>/dev/null | sed -n 's/^sector-size:[ ]*\([0-9]*\).*/\1/p' | head -1)
    case "${_sb_v:-}" in ''|*[!0-9]*) echo 512 ;; *) echo "$_sb_v" ;; esac
}

# ── bytes_del_disco <disco> — el tamaño del APARATO, en bytes ──────────────────────────────────
bytes_del_disco() { echo $(( $(cat "/sys/class/block/$(nombre_kernel "$1")/size" 2>/dev/null || echo 0) * 512 )); }

# ── mib_minimos — el piso, calculado UNA vez ──────────────────────────────────────────────────
# `mib_necesarios` mide el árbol y no es gratis (`du -sm` sobre el rootfs); el censo la llamaría una
# vez por partición. Se cachea en una global, que es la única forma de memoizar en sh.
mib_minimos() {
    [ -n "${MIB_MINIMOS:-}" ] || MIB_MINIMOS=$(mib_necesarios)
    echo "$MIB_MINIMOS"
}

# clasificar <guid-tipo> <fstype> <montaje> [mib] → VEREDICTO|ETIQUETA
# El veredicto es lo que decide el menú: SOLO_ESP, NO_TOCAR, CANDIDATA, RAIZ_VIVA, EN_USO.
clasificar() {
    _cl_guid=$(printf '%s' "${1:-}" | tr 'A-Z' 'a-z')
    _cl_fs="${2:-}"; _cl_mnt="${3:-}"; _cl_mib="${4:-0}"
    case "$_cl_guid" in
        "$GUID_ESP") echo "SOLO_ESP|ESP (partición de arranque EFI)"; return ;;
        "$GUID_MSR") echo "NO_TOCAR|reservada de Microsoft"; return ;;
        "$GUID_WINRE") echo "NO_TOCAR|recuperación de Windows"; return ;;
        "$GUID_SWAP") echo "NO_TOCAR|swap"; return ;;
        # «Datos básicos de Microsoft» es el tipo que Windows le pone a sus volúmenes. Aunque el
        # filesystem no se reconozca —puede estar cerrado por BitLocker, o simplemente vacío— no se
        # ofrece: el coste de equivocarse acá es el disco de otro sistema operativo.
        "$GUID_MSBASIC") echo "NO_TOCAR|volumen de datos de Windows (tipo GPT «basic data»)"; return ;;
        # ⚠ El tipo LUKS de la TABLA tiene que bastar por sí solo. Estaba definido y **no se
        # consultaba**: en la prueba con el layout del usuario, una partición marcada como LUKS en
        # GPT salió ofrecida como «se puede usar» porque `blkid` no veía cabecera dentro. Un
        # contenedor cifrado es justo el caso donde no se puede mirar adentro para decidir — el
        # único dato disponible es el tipo, así que el tipo manda.
        "$GUID_LUKS") echo "NO_TOCAR|VOLUMEN CIFRADO (LUKS, por tipo de la tabla)"; return ;;
    esac
    case "$_cl_fs" in
        crypto_LUKS) echo "NO_TOCAR|VOLUMEN CIFRADO (LUKS) — lo que hay dentro no se puede ver desde acá"; return ;;
        ntfs)        echo "NO_TOCAR|NTFS (Windows u otro sistema)"; return ;;
        vfat|msdos)  echo "NO_TOCAR|FAT — puede ser una ESP o datos compartidos"; return ;;
        swap)        echo "NO_TOCAR|swap"; return ;;
        BitLocker|bitlocker) echo "NO_TOCAR|BitLocker"; return ;;
    esac
    if [ "$_cl_mnt" = "/" ]; then
        # ⚠ **La raíz viva no siempre es del usuario.** Arrancado desde un USB o una imagen, la raíz
        # viva es EL MEDIO — y ofrecerlo como destino es ofrecer formatear el instalador mientras
        # corre. El medio se sabe en el arranque (`TAKANA_MEDIO`, lo pone el `/init` mirando si el
        # cmdline trae `rdinit=`), no se adivina acá.
        if [ -n "${TAKANA_MEDIO:-}" ]; then
            echo "NO_TOCAR|es el MEDIO desde el que arrancaste (el instalador corre desde acá)"; return
        fi
        echo "RAIZ_VIVA|la raíz del sistema que está corriendo AHORA"; return
    fi
    if [ -n "$_cl_mnt" ]; then
        echo "EN_USO|montada en $_cl_mnt"; return
    fi
    # ⚠ **«No reconozco nada» NO es «está vacío», y confundirlos DESTRUYE.** Un almacén de
    # negación plausible (`qullqa`, tawasuyu) es por diseño un dispositivo lleno de aleatorio y sin
    # ninguna firma — o sea **exactamente** lo que un instalador ingenuo llama «partición vacía, se
    # puede usar». Formatearla no filtra información: la borra, y el dueño se entera cuando ya no
    # está. La contención que el editor de discos de tawasuyu ya implementó (su T16) es general y
    # ésta la copia: **lo que no se pudo identificar nace CRUDO, no libre**, y sólo se usa con una
    # confirmación fuerte.
    #
    # Y el mensaje es EL MISMO para un pozo, un disco recién borrado y un contenedor cifrado ajeno.
    # Eso no es pereza: un aviso que dijera «esto parece un volumen oculto» delataría exactamente lo
    # que el diseño existe para no delatar. Acá no se nombra nada de eso, a propósito.
    case "$_cl_fs" in
        ext2|ext3|ext4|xfs|btrfs|f2fs) _cl_q="Linux ($_cl_fs) sin montar" ;;
        "")  _cl_min=$(mib_minimos)
             if [ "${_cl_mib:-0}" -lt "$_cl_min" ] 2>/dev/null; then
                 echo "NO_TOCAR|sin nada que se pueda identificar, y son ${_cl_mib} M (hacen falta ${_cl_min} M)"; return
             fi
             echo "CRUDA|no reconozco NADA acá: puede estar vacía o en uso por algo que este instalador no sabe leer"; return ;;
        *)   echo "NO_TOCAR|$_cl_fs (desconocido para este instalador)"; return ;;
    esac
    # ⚠ **Una candidata que no entra no es una candidata.** Sin esta puerta el censo de este mismo
    # hub ofrecía `/dev/sda1` —2 MiB, sin filesystem, el hueco de arranque— como «✓ se puede usar»:
    # el veredicto sólo miraba QUÉ hay dentro y nunca CUÁNTO cabe. Elegirla formatea algo real y
    # muere a mitad de la copia, que es el peor momento para enterarse. El piso es el mismo número
    # con el que se talla un hueco (`mib_necesarios`), así que las dos puertas no pueden divergir.
    _cl_min=$(mib_minimos)
    if [ "${_cl_mib:-0}" -lt "$_cl_min" ] 2>/dev/null; then
        echo "NO_TOCAR|$_cl_q, pero son ${_cl_mib} M y hacen falta al menos ${_cl_min} M"; return
    fi
    echo "CANDIDATA|$_cl_q"
}

# censo [--solo-candidatas] → una línea por partición, hueco o disco sin tabla:
#   <dev>|<partuuid>|<mib>|<fstype>|<label>|<montaje>|<VEREDICTO>|
#   <clase>|<disco>|<inicio_bytes>|<tamano_bytes>|<tipo_guid>|<explicación>
#
# ⚠ **La explicación va ÚLTIMA a propósito**: es el único campo de texto libre, y con `IFS='|'` el
# último `read` se come lo que sobre. Un campo nuevo va ANTES de ella, y hay que tocar los tres
# lectores (`mostrar_censo`, `censo_json`, `elegir_destino`) — no hay cuarto.
#
# `clase` distingue las tres cosas que no son lo mismo y que hasta hoy se veían iguales:
#   `particion`  una entrada de la tabla
#   `hueco`      espacio sin asignar — **no tiene `dev` propio**: `dev` es el DISCO, y dos huecos
#                del mismo disco traen el mismo `dev`. La identidad de un hueco es
#                `disco` + `inicio_bytes`, y nada más.
#   `disco`      un disco SIN tabla de particiones (formateado directo, o crudo)
censo() {
    _ce_solo="${1:-}"
    for _ce_d in $(discos_del_sistema); do
        _ce_sb=$(sector_bytes_de "$_ce_d")
        # ⚠ Un disco SIN TABLA no es un disco vacío: puede estar formateado directo y montado —así
        # vive el store de este hub, `/dev/sdb` con un ext4 encima y nada más—. Sin esta rama el
        # censo lo OMITE por completo, que es la peor forma de presentar algo que existe y está en
        # uso: invisible. Se lista, se dice que no tiene tabla, y no se ofrece.
        if [ -z "$("$SFDISK" -d "$_ce_d" 2>/dev/null | grep "^${_ce_d}")" ]; then
            _ce_bl=$(blkid "$_ce_d" 2>/dev/null || true)
            _ce_fs=$(printf '%s' "$_ce_bl" | grep -o ' TYPE="[^"]*"'  | head -1 | sed 's/^ TYPE="//; s/"$//')
            _ce_lb=$(printf '%s' "$_ce_bl" | grep -o ' LABEL="[^"]*"' | head -1 | sed 's/^ LABEL="//; s/"$//')
            _ce_mn=$(awk -v d="$_ce_d" '$1==d {print $2; exit}' /proc/mounts 2>/dev/null || true)
            es_la_raiz_viva "$_ce_d" && _ce_mn="/"
            _ce_sz=$(( $(cat "/sys/class/block/$(nombre_kernel "$_ce_d")/size" 2>/dev/null || echo 0) ))
            if [ -n "$_ce_mn" ]; then _ce_v="EN_USO"; _ce_e="disco SIN TABLA de particiones, montado en $_ce_mn"
            else _ce_v="NO_TOCAR"; _ce_e="disco SIN TABLA de particiones (${_ce_fs:-sin filesystem})"; fi
            echo "$_ce_d|-|$(mib_de_sectores "$_ce_sz")|${_ce_fs}|${_ce_lb}|${_ce_mn}|$_ce_v|disco|$_ce_d|0|$(( _ce_sz * 512 ))|-|$_ce_e"
            continue
        fi
        "$SFDISK" -d "$_ce_d" 2>/dev/null | grep "^${_ce_d}" | while IFS= read -r _ce_l; do
            _ce_dev=$(printf '%s' "$_ce_l" | awk '{print $1}')
            _ce_sz=$(printf '%s'  "$_ce_l" | sed -n 's/.*size=[ ]*\([0-9]*\).*/\1/p')
            _ce_st=$(printf '%s'  "$_ce_l" | sed -n 's/.*start=[ ]*\([0-9]*\).*/\1/p')
            _ce_ty=$(printf '%s'  "$_ce_l" | sed -n 's/.*type=\([0-9A-Fa-f-]*\).*/\1/p')
            _ce_uu=$(printf '%s'  "$_ce_l" | sed -n 's/.*uuid=\([0-9A-Fa-f-]*\).*/\1/p')
            _ce_bl=$(blkid "$_ce_dev" 2>/dev/null || true)
            _ce_fs=$(printf '%s' "$_ce_bl" | grep -o ' TYPE="[^"]*"'  | head -1 | sed 's/^ TYPE="//; s/"$//')
            _ce_lb=$(printf '%s' "$_ce_bl" | grep -o ' LABEL="[^"]*"' | head -1 | sed 's/^ LABEL="//; s/"$//')
            _ce_mn=$(awk -v d="$_ce_dev" '$1==d {print $2; exit}' /proc/mounts 2>/dev/null || true)
            # La raíz viva se decide por número de dispositivo, no por el nombre de /proc/mounts.
            if es_la_raiz_viva "$_ce_dev"; then _ce_mn="/"; fi
            # En bytes y con el sector del disco, no con un 2048 horneado: en 4Kn el tamaño sale
            # ocho veces menor y `clasificar` rechaza por chica una partición que sobra.
            _ce_by=$(( _ce_sz * _ce_sb ))
            _ce_ib=$(( ${_ce_st:-0} * _ce_sb ))
            _ce_cl=$(clasificar "$_ce_ty" "$_ce_fs" "$_ce_mn" "$(mib_de_bytes "$_ce_by")")
            _ce_ver="${_ce_cl%%|*}"; _ce_exp="${_ce_cl#*|}"
            [ "$_ce_solo" = "--solo-candidatas" ] && [ "$_ce_ver" != "CANDIDATA" ] && continue
            echo "$_ce_dev|$_ce_uu|$(mib_de_bytes "$_ce_by")|$_ce_fs|$_ce_lb|$_ce_mn|$_ce_ver|particion|$_ce_d|$_ce_ib|$_ce_by|${_ce_ty:--}|$_ce_exp"
        done
        # El espacio SIN ASIGNAR es un candidato más, y el único que no destruye nada.
        # ⚠ Las columnas de `sfdisk -F` son <inicio> <fin> <sectores> <tamaño-legible>, y el inicio
        # es lo que convierte un hueco en algo DIBUJABLE: sin él la cara no sabe entre qué dos
        # particiones cae, y «acá no hay nada» es justo el sitio donde más conviene instalar.
        "$SFDISK" -F "$_ce_d" 2>/dev/null | awk -v d="$_ce_d" -v min="$(mib_minimos)" -v sb="$_ce_sb" \
            'NF==4 && $1 ~ /^[0-9]+$/ { by=$3*sb; ib=$1*sb; m=int(by/1048576);
               if (m >= min) print d"|-|"m"|-|-|-|LIBRE|hueco|"d"|"ib"|"by"|-|espacio sin asignar en "d;
               else print d"|-|"m"|-|-|-|NO_TOCAR|hueco|"d"|"ib"|"by"|-|hueco sin asignar en "d", pero son "m" M y hacen falta al menos "min" M" }'
    done
}

# mostrar_censo — el censo en forma de tabla, con los NO TOCAR dichos en voz alta.
mostrar_censo() {
    _mc_f="${1:-}"
    echo "── el terreno de esta máquina ─────────────────────────────────────────────────"
    [ -n "${RAIZ_MAJMIN:-}" ] || echo "  ⚠ NO pude determinar cuál es la raíz viva de esta máquina: tratá TODO con sospecha."
    printf "  %-3s %-16s %-9s %-11s %s\n" "nº" "partición" "tamaño" "qué es" "veredicto"
    _mc_n=0
    { if [ -n "$_mc_f" ]; then cat "$_mc_f"; else censo; fi; } | while IFS='|' read -r _d _u _m _fs _lb _mn _ver _cla _dis _ib _tb _tg _exp; do
        _mc_n=$(( _mc_n + 1 ))
        case "$_ver" in
            CANDIDATA) _mc_marca="✓ se puede usar (SE BORRA lo que tenga)" ;;
            CRUDA)     _mc_marca="? sin identificar — se puede usar, con confirmación" ;;
            LIBRE)     _mc_marca="✓ instalar AL LADO sin borrar nada" ;;
            RAIZ_VIVA) _mc_marca="⚡ sólo con el salto (kexec)" ;;
            SOLO_ESP)  _mc_marca="· se reusa como ESP, no se formatea" ;;
            EN_USO)    _mc_marca="· en uso" ;;
            *)         _mc_marca="✗ NO TOCAR" ;;
        esac
        printf "  %-3s %-16s %6s M  %-11s %s\n" "$_mc_n" "$_d" "$_m" "${_fs:-—}" "$_mc_marca"
        printf "      %s%s\n" "$_exp" "$( [ -n "$_lb" ] && [ "$_lb" != "-" ] && printf ' · etiqueta «%s»' "$_lb")"
        # ⚠ **Un `a && b && c` como ÚLTIMO comando de un bucle decide el estado de salida del
        # script entero.** Con `set -e`, si la última fila del censo no tiene PARTUUID —un disco sin
        # tabla, un hueco libre— esta línea daba 1, el `while` daba 1, la tubería daba 1 y
        # `mostrar_censo` MORÍA ahí: el separador de cierre no se imprimía y `--survey` salía con 1
        # habiendo funcionado. Medido en este hub el 2026-09-23, donde la última fila es `/dev/sdc`.
        # Un `if` no propaga nada; el `&&` sí.
        if [ -n "$_u" ] && [ "$_u" != "-" ]; then printf "      PARTUUID=%s\n" "$_u"; fi
    done
    echo "───────────────────────────────────────────────────────────────────────────────"
    # Un censo VACÍO no es un error, pero callarlo se lee como «no hay nada que hacer acá». Pasa de
    # verdad: dentro de esta jaula `/dev` no tiene un solo dispositivo de bloque.
    if [ -z "$({ if [ -n "$_mc_f" ]; then cat "$_mc_f"; else censo; fi; } | grep -c . 2>/dev/null | grep -v '^0$')" ]; then
        echo "  (no veo NINGÚN disco desde acá — ¿estás dentro de un contenedor, o sin privilegios?)"
    fi
}

# ── censo_json — el MISMO censo, en JSON. Es el CONTRATO con cualquier cara gráfica ───────────
#
# ⚠ **Existe para que no haya un segundo censo.** La tentación al poner una interfaz encima es que
# la interfaz lea `sfdisk`/`blkid` por su cuenta y clasifique ella; ahí es donde los dos divergen y
# uno de los dos empieza a ofrecer lo que el otro protege — y el que se equivoca formatea. El SDD 28
# §8 ya nombra ese riesgo («un motor, tres frentes»). Entonces: UN censo, UNA clasificación, y las
# caras consumen esto. Si `veredicto` cambia acá, cambia para todas a la vez.
#
# El campo `usable` es la lectura de una sola pregunta —¿se puede instalar acá?— para que una cara
# no tenga que reimplementar el `case` de los veredictos y equivocarse en el default: lo que no
# reconozca NO es usable.
jstr() {
    printf '"%s"' "$(printf '%s' "${1:-}" | sed 's/\\/\\\\/g; s/"/\\"/g; s/\t/ /g' | tr -d '\000-\010\013\014\016-\037')"
}
# ── discos_json — el APARATO, una vez por disco y no repetido en cada fila ─────────────────────
#
# `/dev/sdc` no contesta «¿cuál es el pendrive que acabo de enchufar?». El modelo y si se puede
# desenchufar son las dos señas que lo distinguen del disco de la máquina.
#
# ⚠ Va en un array PROPIO y no como campos de cada partición —que es como se pidió— porque un dato
# del disco repetido en cada fila se puede contradecir entre filas, y entonces hay que decidir a
# cuál creerle. Cada fila trae `disco`, que es la clave acá. Y no hace falta ninguna herramienta:
# todo sale de `/sys` y de la cabecera de `sfdisk -d`.
#
# ⚠ `removible` es el flag del kernel, que es lo que hay: dice «este aparato admite que le saques el
# medio». Un USB sale 1 y un NVMe interno sale 0, que es el caso que importa — pero un lector de
# tarjetas vacío también sale 1, así que **es una seña para pintar, no una garantía**.
discos_json() {
    printf '  "discos": [\n'
    _dj_pri=1
    for _dj_d in $(discos_del_sistema); do
        _dj_n=$(nombre_kernel "$_dj_d")
        _dj_mo=$(sed 's/[[:space:]]*$//' "/sys/class/block/$_dj_n/device/model" 2>/dev/null || true)
        _dj_rm=false
        [ "$(cat "/sys/class/block/$_dj_n/removable" 2>/dev/null || echo 0)" = 1 ] && _dj_rm=true
        _dj_tb=$("$SFDISK" -d "$_dj_d" 2>/dev/null | sed -n 's/^label:[[:space:]]*\(.*\)$/\1/p' | head -1)
        [ "$_dj_pri" = 1 ] || printf ',\n'
        _dj_pri=0
        printf '    {"dev": %s, "modelo": %s, "removible": %s, "tamano_bytes": %s, "sector_bytes": %s, "tabla": %s}' \
            "$(jstr "$_dj_d")" \
            "$( [ -n "${_dj_mo:-}" ] && jstr "$_dj_mo" || printf 'null' )" \
            "$_dj_rm" \
            "$(bytes_del_disco "$_dj_d")" \
            "$(sector_bytes_de "$_dj_d")" \
            "$( [ -n "${_dj_tb:-}" ] && jstr "$_dj_tb" || printf 'null' )"
    done
    printf '\n  ],\n'
}

censo_json() {
    _cj_f="${1:-}"
    printf '{\n'
    printf '  "version": 2,\n'
    printf '  "raiz_viva": %s,\n' "$( [ -n "${RAIZ_MAJMIN:-}" ] && jstr "$RAIZ_MAJMIN" || printf 'null' )"
    discos_json
    printf '  "particiones": [\n'
    _cj_pri=1
    { if [ -n "$_cj_f" ]; then cat "$_cj_f"; else censo; fi; } | while IFS='|' read -r _d _u _m _fs _lb _mn _ver _cla _dis _ib _tb _tg _exp; do
        [ -n "$_d" ] || continue
        case "$_ver" in CANDIDATA|LIBRE|RAIZ_VIVA|CRUDA) _cj_us=true ;; *) _cj_us=false ;; esac
        [ "$_cj_pri" = 1 ] || printf ',\n'
        _cj_pri=0
        printf '    {"dev": %s, "partuuid": %s, "mib": %s, "fs": %s, "etiqueta": %s, "montaje": %s, "veredicto": %s, "usable": %s, "clase": %s, "disco": %s, "inicio_bytes": %s, "tamano_bytes": %s, "tipo_guid": %s, "explicacion": %s}' \
            "$(jstr "$_d")" \
            "$( [ "${_u:--}" = "-" ] && printf 'null' || jstr "$_u" )" \
            "${_m:-0}" \
            "$( [ "${_fs:--}" = "-" ] || [ -z "${_fs:-}" ] && printf 'null' || jstr "$_fs" )" \
            "$( [ "${_lb:--}" = "-" ] || [ -z "${_lb:-}" ] && printf 'null' || jstr "$_lb" )" \
            "$( [ "${_mn:--}" = "-" ] || [ -z "${_mn:-}" ] && printf 'null' || jstr "$_mn" )" \
            "$(jstr "$_ver")" "$_cj_us" \
            "$(jstr "${_cla:-particion}")" \
            "$( [ -n "${_dis:-}" ] && [ "${_dis}" != "-" ] && jstr "$_dis" || printf 'null' )" \
            "${_ib:-0}" "${_tb:-0}" \
            "$( [ "${_tg:--}" = "-" ] || [ -z "${_tg:-}" ] && printf 'null' || jstr "$(printf '%s' "$_tg" | tr 'A-Z' 'a-z')" )" \
            "$(jstr "$_exp")"
    done
    printf '\n  ]\n}\n'
}

# ── partuuid_de <dev> — la identidad estable de una partición, leída de la TABLA ──────────────
partuuid_de() {
    "$SFDISK" -d "$(disco_de "$1")" 2>/dev/null \
        | awk -v d="$1" '$1==d {for(i=1;i<=NF;i++) if ($i ~ /^uuid=/) {sub(/,$/,"",$i); sub(/^uuid=/,"",$i); print $i; exit}}'
}

# ── elegir_destino — el modo interactivo, que es lo que hace de esto un instalador ────────────
# Sin esto hay que saber de antemano el PARTUUID de la máquina de destino, o sea preparar un medio
# distinto por máquina. Con esto el MISMO medio sirve en cualquiera: arranca, mira y ofrece.
# Deja la elección en DEST / USE_FREE / DISK del llamador.
# ⚠ `/tmp` puede NO EXISTIR. Medido dentro del initramfs: el censo no pudo escribir su fichero y el
# mensaje que salió fue «no veo ningún disco en esta máquina» — con once discos a la vista dos
# líneas más abajo. Un diagnóstico que culpa al hardware cuando falta un directorio manda a
# desarmar la máquina equivocada. Ahora se busca un sitio escribible y, si no hay ninguno, se dice
# ESO.
dir_temporal() {
    for _dt in "${TMPDIR:-}" /tmp /run /dev/shm .; do
        [ -n "$_dt" ] || continue
        [ -d "$_dt" ] || continue
        if ( : > "$_dt/.takana-escritura.$$" ) 2>/dev/null; then
            rm -f "$_dt/.takana-escritura.$$"; echo "$_dt"; return 0
        fi
    done
    return 1
}

elegir_destino() {
    _ed_dir=$(dir_temporal) || {
        echo "takana-install-partition: no encuentro ningún directorio donde escribir (/tmp, /run…)" >&2
        return 1; }
    _ed_f="$_ed_dir/.takana-censo.$$"
    censo > "$_ed_f" 2>/dev/null
    [ -s "$_ed_f" ] || { echo "takana-install-partition: no veo ningún disco en esta máquina" >&2; rm -f "$_ed_f"; return 1; }
    mostrar_censo "$_ed_f"
    echo "  Lo marcado ✗ NO TOCAR no se ofrece: son sistemas de otros, volúmenes cifrados o swap."
    echo "  Elegir una ✓ BORRA lo que tenga. «Al lado» no borra nada."
    _ed_n=0
    printf "  opciones: "
    while IFS='|' read -r _d _u _m _fs _lb _mn _ver _cla _dis _ib _tb _tg _exp; do
        _ed_n=$(( _ed_n + 1 ))
        # ⚠ `CRUDA` tiene que estar acá. Sin ella la línea salía VACÍA en un disco cuyo único
        # destino posible era una partición sin identificar: el menú ofrecía la opción 4 y a la vez
        # decía «opciones: (ninguna)». Medido en el arnés del USB el 2026-09-23. Una lista de
        # opciones que no coincide con lo que la tabla marca es peor que no tenerla.
        case "$_ver" in CANDIDATA|LIBRE|RAIZ_VIVA|CRUDA) printf "%s " "$_ed_n" ;; esac
    done < "$_ed_f"
    echo
    printf "  nº (o 'no' para salir sin tocar nada): "
    read -r _ed_sel || _ed_sel=no
    case "$_ed_sel" in
        ''|no|NO|n) echo "  cancelado: no se tocó nada."; rm -f "$_ed_f"; return 1 ;;
    esac
    _ed_linea=$(sed -n "${_ed_sel}p" "$_ed_f" 2>/dev/null)
    rm -f "$_ed_f"
    [ -n "$_ed_linea" ] || { echo "takana-install-partition: «$_ed_sel» no es una de las opciones" >&2; return 1; }
    _ed_dev=$(printf '%s' "$_ed_linea" | cut -d'|' -f1)
    _ed_uu=$(printf  '%s' "$_ed_linea" | cut -d'|' -f2)
    _ed_ver=$(printf '%s' "$_ed_linea" | cut -d'|' -f7)
    case "$_ed_ver" in
        LIBRE)     USE_FREE=1; DISK="$_ed_dev"; DEST=""
                   echo "  ⇒ instalar AL LADO, en el espacio libre de $_ed_dev" ;;
        CRUDA)
                   # Confirmación FUERTE, y distinta de un «sí»: se teclea el nombre del device.
                   # Un `sí` se contesta por reflejo; escribir `/dev/nvme0n1p5` obliga a mirar.
                   echo "  ⚠ En $_ed_dev no se reconoce NADA. Puede estar vacía — o puede tener algo"
                   echo "    que este instalador no sabe leer, y formatearla lo borra sin aviso."
                   printf "    Escribí el nombre completo (%s) para confirmar, o cualquier otra cosa para salir: " "$_ed_dev"
                   read -r _ed_conf
                   [ "$_ed_conf" = "$_ed_dev" ] || { echo "  cancelado: no se tocó nada."; return 1; }
                   if [ -n "$_ed_uu" ] && [ "$_ed_uu" != "-" ]; then DEST="PARTUUID=$_ed_uu"; else DEST="$_ed_dev"; fi
                   echo "  ⇒ destino: $_ed_dev ($DEST)" ;;
        CANDIDATA|RAIZ_VIVA)
                   # Por PARTUUID SIEMPRE que se pueda: el nombre de device puede cambiar entre
                   # este momento y el arranque siguiente (ver `resolver_dev`).
                   if [ -n "$_ed_uu" ] && [ "$_ed_uu" != "-" ]; then DEST="PARTUUID=$_ed_uu"; else DEST="$_ed_dev"; fi
                   echo "  ⇒ destino: $_ed_dev ($DEST)" ;;
        *) echo "takana-install-partition: esa partición está marcada como NO TOCAR y no se ofrece" >&2; return 1 ;;
    esac
    return 0
}

# ── esp_automatica [disco-del-destino] — la ESP no se pregunta si se puede deducir ────────────
# Regla: la ESP del MISMO disco que el destino; si ahí no hay, la única del sistema. Si hay varias y
# ninguna en ese disco, se pregunta: elegir entre las ESP de dos sistemas operativos distintos es
# justo la clase de decisión que un instalador no debe tomar solo.
esp_automatica() {
    _ea_disco="${1:-}"
    _ea_todas=$(censo | awk -F'|' '$7=="SOLO_ESP" {print $1}')
    [ -n "$_ea_todas" ] || return 1
    if [ -n "$_ea_disco" ]; then
        for _ea_e in $_ea_todas; do
            case "$_ea_e" in "$_ea_disco"*) echo "$_ea_e"; return 0 ;; esac
        done
    fi
    _ea_n=$(printf '%s\n' "$_ea_todas" | grep -c .)
    if [ "$_ea_n" = "1" ]; then printf '%s\n' "$_ea_todas"; return 0; fi
    echo "takana-install-partition: hay $_ea_n ESP y ninguna en el disco del destino. Pasá --esp:" >&2
    printf '%s\n' "$_ea_todas" | sed 's/^/      /' >&2
    return 1
}

# ── mib_necesarios — cuánto pedirle al hueco ──────────────────────────────────────────────────
# El rootfs medido + 40 %, con piso de 2 GiB. El margen no es superstición: `mke2fs` se queda con
# ~1,5 % en metadatos y el sistema instalado tiene que poder escribir algo antes de que alguien lo
# agrande. Un destino que entra JUSTO produce un sistema que arranca y se llena a la semana.
mib_necesarios() {
    _mn_r="${ROOTFS:-}"
    [ -z "$_mn_r" ] && _mn_r=$(ls -dt store/*-product-rootfs /store/*-product-rootfs 2>/dev/null | head -1)
    _mn_m=$(du -sm "$_mn_r" 2>/dev/null | cut -f1)
    [ -z "${_mn_m:-}" ] && _mn_m=1024
    _mn_m=$(( _mn_m * 14 / 10 ))
    [ "$_mn_m" -lt 2048 ] && _mn_m=2048
    echo "$_mn_m"
}

# ── crear_en_hueco <disco> <mib> — la ÚNICA vez que este script escribe la tabla ───────────────
# `sfdisk --append` añade una entrada y **no reescribe las existentes**: es la diferencia entre
# «instalar al lado» y el `o` de `takana-live-install.sh`, que empieza por tirar la tabla entera.
# Aun así es la operación más delicada de acá, así que: se elige el hueco MÁS GRANDE, se dice cuál
# es con sus sectores a la vista, y se pide confirmación aparte de la del formateo.
crear_en_hueco() {
    _ch_disco="$1"; _ch_mib="$2"
    _ch_libre=$("$SFDISK" -F "$_ch_disco" 2>/dev/null | awk 'NF==4 && $1 ~ /^[0-9]+$/ {if ($3+0 > m) {m=$3+0; s=$1; e=$2}} END {if (m>0) print s, e, m}')
    [ -n "$_ch_libre" ] || { echo "takana-install-partition: $_ch_disco no tiene espacio SIN ASIGNAR" >&2; return 1; }
    _ch_start=$(echo "$_ch_libre" | cut -d' ' -f1)
    _ch_sect=$(echo  "$_ch_libre" | cut -d' ' -f3)
    _ch_libre_mib=$(( _ch_sect / 2048 ))
    echo "    hueco más grande: ${_ch_libre_mib} MiB desde el sector ${_ch_start}" >&2
    [ "$_ch_libre_mib" -ge "$_ch_mib" ] || {
        echo "takana-install-partition: el hueco da ${_ch_libre_mib} MiB y hacen falta ${_ch_mib} MiB." >&2
        echo "                          Nada que hacer sin encoger algo, y encoger pide otro medio." >&2; return 1; }
    # **El hueco ENTERO, no el mínimo.** `$_ch_mib` es lo que hace falta para que entre el sistema;
    # usar eso deja una raíz del tamaño justo y el resto del hueco sin asignar, que no le sirve a
    # nadie. Quien dice «instalá en mi espacio libre» quiere su espacio libre: medido el 2026-10-02
    # sobre un disco con 12 GiB sin asignar, la partición salía de 2 GiB —el mínimo— y la pantalla
    # ya había prometido los 12. Un instalador que promete una cosa y hace otra es peor que uno que
    # promete poco.
    #
    # Se recorta a múltiplo de MiB para no dejar una cola de sectores sueltos al final.
    _ch_size=$(( (_ch_sect / 2048) * 2048 ))
    _ch_usa_mib=$(( _ch_size / 2048 ))
    if [ -z "$ASSUME_YES" ] && [ -t 0 ]; then
        printf "    voy a AÑADIR una partición de %s MiB a la tabla de %s (las existentes no se tocan) [escribí si] " "$_ch_usa_mib" "$_ch_disco" >&2
        read -r _ch_r; [ "$_ch_r" = "si" ] || { echo "    cancelado." >&2; return 1; }
    fi
    echo "    la partición nueva se lleva el hueco entero: ${_ch_usa_mib} MiB" >&2
    # La lista de ANTES, para saber después cuál es la nueva por DIFERENCIA y no por su nombre.
    # ⚠ El primer intento buscaba la línea por `start=<sector>` y nunca la encontraba: `sfdisk -d`
    # **alinea los campos con espacios** (`start=     3614720`), así que el patrón sin espacios no
    # casa jamás. El síntoma era idéntico al de un device que no aparece — y mandó a buscar el fallo
    # en `partx` y en udev, que estaban bien. Comparar conjuntos no depende del formato.
    _ch_lista_antes=$("$SFDISK" -d "$_ch_disco" 2>/dev/null | awk '/^\/dev/ {print $1}')
    _ch_antes=$(printf '%s\n' "$_ch_lista_antes" | grep -c . || true)
    echo "start=$_ch_start, size=$_ch_size, type=linux, name=\"takana-root\"" \
        | "$SFDISK" --append --quiet "$_ch_disco" >/dev/null 2>&1 \
        || { echo "takana-install-partition: sfdisk --append falló sobre $_ch_disco" >&2; return 1; }
    # El device nuevo tarda en aparecer (udev, o `partx` en un loop): esperarlo es obligatorio, y el
    # nombre se LEE de la tabla en vez de construirlo a mano — `nvme0n1p4` y `sda4` no se escriben igual.
    releer_tabla "$_ch_disco"
    _ch_nuevo=""
    _ch_i=0
    while [ "$_ch_i" -lt 15 ]; do
        _ch_lista_post=$("$SFDISK" -d "$_ch_disco" 2>/dev/null | awk '/^\/dev/ {print $1}')
        for _ch_d in $_ch_lista_post; do
            case " $(printf '%s ' $_ch_lista_antes)" in
                *" $_ch_d "*) ;;
                *) _ch_nuevo="$_ch_d" ;;
            esac
        done
        [ -n "$_ch_nuevo" ] && [ -b "$_ch_nuevo" ] && break
        _ch_nuevo=""
        _ch_i=$(( _ch_i + 1 )); sleep 1
        releer_tabla "$_ch_disco"
    done
    [ -n "$_ch_nuevo" ] && [ -b "$_ch_nuevo" ] || {
        echo "takana-install-partition: la partición se añadió pero su device no apareció (¿hace falta un partprobe?)" >&2; return 1; }
    _ch_despues=$("$SFDISK" -d "$_ch_disco" 2>/dev/null | awk '/^\/dev/ {print $1}' | grep -c . || true)
    [ "$_ch_despues" = "$(( _ch_antes + 1 ))" ] || {
        echo "takana-install-partition: la tabla pasó de $_ch_antes a $_ch_despues entradas — esperaba UNA más" >&2; return 1; }
    echo "$_ch_nuevo"
}

# `--survey`: mirar y no tocar. Es el comando con el que se empieza en una máquina desconocida.
if [ -n "$SOLO_CENSO" ]; then
    if [ -n "$CENSO_JSON" ]; then censo_json; else mostrar_censo; fi
    exit 0
fi

# ── `--pick`: ELEGIR sin tocar ────────────────────────────────────────────────────────────────
# Existe por una razón que costó un susto: hasta hoy el orden era «saltá primero, elegí después»,
# o sea que TODA la conversación con la persona pasaba DESPUÉS del kexec — en una máquina donde el
# panel puede no volver a encenderse. El usuario dijo que sí al salto, la pantalla se fue a negro y
# se quedó así: el instalador estaba vivo del otro lado esperando una tecla que nadie podía ver que
# le estaba pidiendo.
#
# Con `--pick` la elección se hace ANTES, en el sistema que todavía funciona, y lo que pasa después
# del salto ya no necesita pantalla: va con la respuesta puesta en la cmdline. Un panel muerto pasa
# de ser un cuelgue a ser un detalle estético.
#
# No toca nada: no resuelve el device, no formatea, no escribe la tabla. Sólo imprime la elección.
if [ -n "$SOLO_ELEGIR" ]; then
    [ -t 0 ] || { echo "takana-install-partition: --pick necesita una terminal para preguntar" >&2; exit 2; }
    elegir_destino || exit 1
    # Se imprime en stdout y en el formato más tonto posible, para que lo lea un programa sin
    # adivinar: una línea por respuesta, `CLAVE=valor`, nada más.
    : > "$SOLO_ELEGIR"
    [ -n "$DEST" ]     && echo "DEST=$DEST" >> "$SOLO_ELEGIR"
    [ -n "$USE_FREE" ] && echo "FREE=1"     >> "$SOLO_ELEGIR"
    [ -n "$DISK" ]     && echo "DISK=$DISK" >> "$SOLO_ELEGIR"
    exit 0
fi

if [ -n "$NECESITA_ELEGIR" ]; then
    if [ -t 0 ]; then
        elegir_destino || exit 1
    else
        echo "takana-install-partition: no me diste destino y no hay terminal para preguntarte." >&2
        echo "                          Pasá --root-part PARTUUID=… o --use-free-space --disk …" >&2
        echo "                          (y mirá el terreno con --survey)" >&2
        exit 2
    fi
fi

# La identidad se resuelve ANTES de cualquier guarda: a partir de acá se trabaja con el device real,
# y si el `PARTUUID` no existe en esta máquina se aborta sin haber tocado nada.
if [ -n "$DEST" ]; then DEST=$(resolver_dev "$DEST") || exit 1; fi
if [ -n "$ESP" ];  then ESP=$(resolver_dev "$ESP")   || exit 1; fi

# `--use-free-space` sin `--root-part`: el destino todavía no existe, se crea en un hueco. Esto es
# «instalar al lado», y es el camino que la política de la raíz viva usa cuando no hay kexec.
if [ -n "$USE_FREE" ] && [ -z "$DEST" ]; then
    _ufs_disco="${DISK:-}"
    if [ -z "$_ufs_disco" ] && [ -n "$ESP" ] && [ -b "$ESP" ]; then _ufs_disco=$(disco_de "$ESP"); fi
    [ -n "$_ufs_disco" ] || { echo "takana-install-partition: --use-free-space necesita --disk (o un --esp real)" >&2; exit 2; }
    echo "==> buscando espacio SIN ASIGNAR en $_ufs_disco"
    DEST=$(crear_en_hueco "$_ufs_disco" "$(mib_necesarios)") || exit 1
    echo "    partición creada: $DEST"
fi

# La ESP: si no se dijo cuál, se deduce del disco del destino. Una pregunta menos que hacerle al
# usuario, y la respuesta correcta en el caso normal (un disco, una ESP).
if [ -z "$ESP" ] && [ -n "$DEST" ] && [ -b "$DEST" ]; then
    _esp_auto=$(esp_automatica "$(disco_de "$DEST")" 2>/dev/null || true)
    [ -n "${_esp_auto:-}" ] && { ESP="$_esp_auto"; echo "==> ESP deducida: $ESP (del mismo disco que el destino)"; }
fi

if es_bloque "$DEST"; then
    _n=$(nombre_kernel "$DEST")
    # 1) DESTINO TIENE QUE SER UNA PARTICIÓN, NO UN DISCO. `/sys/class/block/<x>/partition` sólo
    #    existe en particiones: es la diferencia entre formatear 200 G y formatear 1,8 T.
    [ -r "/sys/class/block/$_n/partition" ] || {
        echo "takana-install-partition: $DEST NO es una partición (¿es el disco entero?)." >&2
        echo "                          Este instalador nunca escribe un disco completo." >&2; exit 1; }
    # 2) NO PUEDE ESTAR MONTADA. mke2fs sobre un fs montado corrompe el que está en uso.
    if grep -q "^$(readlink -f "$DEST") " /proc/mounts 2>/dev/null; then
        echo "takana-install-partition: $DEST está MONTADA. Desmontala primero (o elegí otra)." >&2
        grep "^$(readlink -f "$DEST") " /proc/mounts >&2; exit 1
    fi
    # 3) NO PUEDE SER LA RAÍZ VIVA. Es el caso que el usuario pregunta siempre: «¿puedo instalar
    #    encima del Linux que estoy usando?». No desde él: hay que saltar antes a otro kernel/medio.
    # Por número de dispositivo, no por nombre: ver `raiz_viva_majmin`. El fallback por nombre se
    # conserva porque no estorba y cubre el caso en que `stat` no exista.
    _rootdev=$(awk '$2=="/" {print $1; exit}' /proc/mounts 2>/dev/null || true)
    if es_la_raiz_viva "$DEST" || \
       [ "$(readlink -f "$DEST")" = "$(readlink -f "${_rootdev:-/nonexistent}" 2>/dev/null || echo /nonexistent)" ]; then
        politica_raiz_viva      # kexec → espacio libre → abortar, según --on-active-root
    fi
    # 4) NO PUEDE SER LA ESP que vamos a reusar.
    [ -n "$ESP" ] && [ "$(readlink -f "$DEST")" = "$(readlink -f "$ESP")" ] && {
        echo "takana-install-partition: --root-part y --esp son la MISMA partición" >&2; exit 1; }
    # 5) ¿ENTRA? Esto AVISA y no aborta, a propósito. El censo esconde del menú lo que no llega al
    #    piso de `mib_necesarios` —que es el mismo con el que se talla un hueco, generoso a
    #    propósito—, pero quien nombra una partición con `--root-part` la está nombrando a mano y
    #    puede saber que su destino justo entra: el banco de pruebas instala en 1200 MiB y funciona.
    #    Abortar acá rechazaría configuraciones que andan; callarse dejaría el fallo para la mitad
    #    de la copia, con el destino ya formateado. Avisar es lo único que no miente.
    _mib_dest=$(mib_de_sectores "$(cat "/sys/class/block/$_n/size" 2>/dev/null || echo 0)")
    _mib_pide=$(mib_minimos)
    if [ "${_mib_dest:-0}" -gt 0 ] && [ "$_mib_dest" -lt "$_mib_pide" ] 2>/dev/null; then
        echo "    ⚠ $DEST son ${_mib_dest} MiB y el sistema pide ~${_mib_pide} MiB con holgura." >&2
        echo "      Sigo porque lo nombraste vos; si no entra, la copia falla con el destino ya formateado." >&2
    fi
else
    [ -f "$DEST" ] || { echo "takana-install-partition: $DEST no existe (ni bloque ni fichero)" >&2; exit 1; }
fi

# ── politica_raiz_viva — el «saltito»: qué hacer si el destino ES el sistema que corre ────────
# La pregunta que todo el mundo hace es «¿puedo poner takana encima del Linux que estoy usando, sin
# USB?». La respuesta honesta tiene tres partes y este bloque las implementa en orden:
#
#   1. Desde adentro, NO. Un filesystem montado y en uso no se formatea; eso es el kernel, no una
#      política nuestra.
#   2. Pero se puede SALIR de adentro sin reiniciar por el firmware: `kexec` salta a otro kernel con
#      un instalador en RAM, y en ese salto el sistema viejo deja de correr ⇒ su disco queda libre.
#      Es el ADR 0017 §1, y el syscall ya estaba implementado (`kexec_file_load`, sin kexec-tools).
#   3. Y si esta máquina no puede saltar —kernel sin `CONFIG_KEXEC_FILE`, o lockdown por Secure
#      Boot— no se fuerza nada: se instala AL LADO, en espacio sin asignar, y el usuario elige en el
#      arranque. Peor camino, cero riesgo.
#
# `--on-active-root` permite fijar uno de los tres a mano; `auto` es la política de arriba.
politica_raiz_viva() {
    echo "⚠ $DEST es la RAÍZ VIVA: el sistema que está corriendo ahora mismo."
    echo "  Un filesystem montado y en uso no se puede formatear desde adentro."
    case "$ON_ACTIVE" in
        abort)
            echo "  --on-active-root=abort ⇒ no hago nada más." >&2; exit 1 ;;
    esac
    _prv_kexec=no
    if [ "$ON_ACTIVE" = auto ] || [ "$ON_ACTIVE" = kexec ]; then
        echo "==> ¿puede esta máquina saltar a otro kernel sin pasar por el firmware?"
        if _prv_out=$("$HAMMER" kernel kexec --probe 2>&1); then _prv_kexec=si; fi
        printf '%s\n' "$_prv_out" | sed 's/^/    /'
    fi
    if [ "$_prv_kexec" = si ]; then
        camino_kexec    # no vuelve: salta
        exit 0
    fi
    if [ "$ON_ACTIVE" = kexec ]; then
        echo "  --on-active-root=kexec y esta máquina no puede saltar (motivos arriba)." >&2; exit 1
    fi
    echo "==> sin kexec ⇒ INSTALO AL LADO, en espacio sin asignar (la raíz viva no se toca)"
    _prv_disco=$(disco_de "$DEST")
    DEST=$(crear_en_hueco "$_prv_disco" "$(mib_necesarios)") || {
        echo "takana-install-partition: no hay hueco donde instalar al lado, y sin kexec no hay otra" >&2
        echo "                          desde este sistema. Queda el camino del medio externo (USB)." >&2
        exit 1; }
    echo "    destino nuevo: $DEST (la raíz viva sigue intacta)"
}

# ── camino_kexec — armar el instalador en RAM y saltar. NO VUELVE ─────────────────────────────
camino_kexec() {
    echo "==> camino KEXEC: el instalador viaja en RAM y el sistema viejo muere en el salto"
    # ⚠ **La elección viaja por la CMDLINE, no horneada en el initramfs.** Un initramfs con el
    # destino adentro sirve para una máquina y hay que rehacerlo para la siguiente; el mismo fichero
    # con la elección en la cmdline sirve para todas. Y va por **PARTUUID**: el kernel de después
    # del salto puede enumerar los discos con otros nombres (medido), así que `/dev/nvme1n1p6` es
    # justamente lo que NO hay que pasar.
    _ck_ru=$(partuuid_de "$DEST" 2>/dev/null || true)
    _ck_eu=""; [ -n "$ESP" ] && _ck_eu=$(partuuid_de "$ESP" 2>/dev/null || true)
    _ck_cl="${CMDLINE_SALTO:-console=ttyS0,115200 console=tty0}"
    if [ -n "$_ck_ru" ]; then _ck_cl="$_ck_cl takana.root=PARTUUID=$_ck_ru"
    else                      _ck_cl="$_ck_cl takana.root=$DEST"; fi
    if [ -n "$_ck_eu" ]; then _ck_cl="$_ck_cl takana.esp=PARTUUID=$_ck_eu"
    elif [ -n "$ESP" ];  then _ck_cl="$_ck_cl takana.esp=$ESP"; fi
    [ -n "$ASSUME_YES" ] && _ck_cl="$_ck_cl takana.yes"
    _ck_ird="${IRD_INSTALADOR:-work/takana-instalador.cpio.gz}"
    OUT="$_ck_ird" KERNEL="$KERNEL" ./scripts/instalador-initramfs.sh || {
        echo "takana-install-partition: no pude armar el instalador en RAM" >&2; exit 1; }
    _ck_art=$(dirname "$(dirname "$KERNEL")")     # …/<hash>-linux-metal/boot/bzImage → el artefacto
    echo
    echo "  kernel:  $_ck_art"
    echo "  initrd:  $_ck_ird ($(du -h "$_ck_ird" | cut -f1)) — genérico, sin esta máquina adentro"
    echo "  destino: $DEST"
    echo "  cmdline: $_ck_cl"
    if [ -z "$ASSUME_YES" ] && [ -t 0 ]; then
        printf "  ⚡ ESTE COMANDO MATA EL SISTEMA QUE ESTÁS USANDO y arranca el instalador. [escribí saltar] "
        read -r _ck_r; [ "$_ck_r" = "saltar" ] || { echo "  cancelado — no se saltó y no se tocó nada."; exit 1; }
    fi
    # ⚠ **El orden de las `console=` decide cuál es `/dev/console`: gana la ÚLTIMA.** Con
    # `console=tty0 console=ttyS0,115200` la consola es el SERIAL, y un portátil no tiene puerto
    # serie: el instalador arrancaría y la pantalla se quedaría en negro con todo pasando en un
    # cable que no existe. Es el bug que este repo ya pagó dos veces (ver `arranque-visible-cada-capa`).
    # Por eso acá tty0 va ÚLTIMO: pantalla primero, serial de regalo para quien lo tenga.
    "$HAMMER" kernel kexec "$_ck_art" --initrd "$_ck_ird" --cmdline "$_ck_cl" --jump
    echo "takana-install-partition: el salto volvió, o sea que NO saltó. Nada se tocó." >&2
    exit 1
}

# ── CONSERVAR UNA PARTICIÓN (`--keep`) — el /home que se queda donde está ──────────────────────
#
# El pedido, textual: «/home, al menos, quiero que quede donde está». Conservarlo es fácil —basta
# con NO formatearlo—; lo difícil es que el sistema nuevo pueda USARLO, y eso es una decisión que no
# se puede dejar a una cara gráfica:
#
#   **Si el usuario que crea takana no tiene el mismo uid que el del sistema viejo, los archivos
#   quedan de otro dueño y el escritorio arranca sin poder escribir en su propia carpeta.**
#
# Decidido (2026-09-25): takana **crea los usuarios con el uid que encuentra**, todos los que haya,
# y el login por defecto es el NOMBRE DEL DIRECTORIO en /home. No se hace `chown` de nada: recorrer
# cientos de miles de ficheros es lento, es destructivo sobre los metadatos y pierde el reparto si
# había más de un dueño. El uid de los datos manda; el del sistema nuevo se adapta.
#
# Las tres condiciones son de este lado y se cumplen acá:
#   1. NO se formatea. Es el punto entero.
#   2. Se comprueba que MONTA y que tiene espacio **antes** de tocar la raíz. Descubrir que el /home
#      que se iba a conservar no monta, con la raíz ya formateada, es el peor momento posible.
#   3. Se DECLARA en el plan, junto a lo que sí se borra.

# keep_parsear — <spec>:<punto>. El punto se corta por el ÚLTIMO «:» porque el spec puede traerlo
# (`UUID=…` no, pero un `/dev/…` raro sí, y un LABEL con dos puntos es legal).
keep_parsear() {
    KEEP_PUNTO="${KEEP_SPEC##*:}"
    _kp_spec="${KEEP_SPEC%:*}"
    [ -n "$_kp_spec" ] && [ "$_kp_spec" != "$KEEP_SPEC" ] || {
        echo "takana-install-partition: --keep se escribe <partición>:<punto>, p.ej. PARTUUID=…:/home" >&2; exit 2; }
    # Un solo punto admitido hoy, y se dice en voz alta en vez de aceptar cualquiera y montar mal.
    # /usr o /etc conservados de otro sistema no es «conservar datos»: es arrancar un híbrido.
    [ "$KEEP_PUNTO" = "/home" ] || {
        echo "takana-install-partition: --keep hoy sólo admite /home (pediste '$KEEP_PUNTO')." >&2
        echo "                          Conservar /usr o /etc de otro sistema no es conservar datos:" >&2
        echo "                          es arrancar un híbrido de dos distros. No se ofrece." >&2; exit 2; }
    KEEP_DEV=$(resolver_dev "$_kp_spec") || exit 1
}

# keep_validar — todas las guardas + la cosecha de usuarios. Corre ANTES de la confirmación, para
# que el plan pueda decir a quién va a crear. Deja la lista en $KEEP_USUARIOS (login:uid:gid).
KEEP_USUARIOS="${TMPDIR:-/tmp}/takana-keep-usuarios.$$"
keep_validar() {
    es_bloque "$KEEP_DEV" || { echo "takana-install-partition: --keep $KEEP_DEV no es un dispositivo de bloque" >&2; exit 1; }
    # 1) No puede ser el destino ni la ESP: conservar lo que se va a formatear no significa nada, y
    #    que el error sea «no significa nada» no impide que borre.
    [ "$(readlink -f "$KEEP_DEV")" = "$(readlink -f "$DEST")" ] && {
        echo "takana-install-partition: --keep y --root-part son la MISMA partición ($KEEP_DEV)." >&2
        echo "                          El destino SE FORMATEA: no se puede conservar." >&2; exit 1; }
    [ -n "$ESP" ] && [ "$(readlink -f "$KEEP_DEV")" = "$(readlink -f "$ESP")" ] && {
        echo "takana-install-partition: --keep es la ESP ($KEEP_DEV). La ESP no es un /home." >&2; exit 1; }
    # 2) Ni la raíz viva: es la que el kexec va a soltar, y montarla como /home del sistema nuevo
    #    mete un árbol de sistema entero dentro de /home.
    es_la_raiz_viva "$KEEP_DEV" && {
        echo "takana-install-partition: --keep $KEEP_DEV es la RAÍZ VIVA, no un /home suelto." >&2; exit 1; }
    # 3) El UUID del FILESYSTEM, que es con lo que se va a montar en el arranque.
    #    ⚠ Por UUID y no por PARTUUID **porque el `findfs` de busybox no entiende PARTUUID**: sólo
    #    LABEL y UUID (medido, 1.36.1). Un findfs PARTUUID=… sale VACÍO sin error, y el resultado
    #    sería un arranque sin /home con todo aparentemente bien. El PARTUUID se anota igual.
    KEEP_UUID=$(blkid "$KEEP_DEV" 2>/dev/null | grep -o ' UUID="[^"]*"' | head -1 | sed 's/^ UUID="//; s/"$//')
    [ -n "$KEEP_UUID" ] || KEEP_UUID=$(blkid -s UUID -o value "$KEEP_DEV" 2>/dev/null || true)
    [ -n "$KEEP_UUID" ] || {
        echo "takana-install-partition: $KEEP_DEV no tiene UUID de filesystem — no hay nada formateado ahí." >&2
        echo "                          Conservar una partición cruda no conserva ningún dato." >&2; exit 1; }
    KEEP_PARTUUID=$(partuuid_de "$KEEP_DEV" 2>/dev/null || true)
    # 4) ¿MONTA? Ésta es la guarda que el pedido pone primero, y con razón.
    #    ⚠ Si YA está montada, se lee de donde está y **no se desmonta**: un `umount` de un montaje
    #    que no hicimos nosotros puede propagarse al original (medido en este repo con /sys/fs/cgroup).
    KEEP_DIR=$(awk -v d="$(readlink -f "$KEEP_DEV")" '$1==d {print $2; exit}' /proc/mounts 2>/dev/null || true)
    if [ -n "$KEEP_DIR" ]; then
        echo "    (el /home a conservar ya está montado en $KEEP_DIR: lo leo de ahí y NO lo desmonto)"
    else
        KEEP_DIR="/run/takana-keep"
        mkdir -p "$KEEP_DIR"
        mount -o ro,nodev,nosuid,noexec "$KEEP_DEV" "$KEEP_DIR" 2>/dev/null || {
            echo "takana-install-partition: $KEEP_DEV NO SE PUEDE MONTAR (probé sólo-lectura)." >&2
            echo "                          No sigo: conservar un /home que no monta dejaría la raíz" >&2
            echo "                          formateada y los datos inalcanzables." >&2; exit 1; }
        KEEP_MONTE_YO=1
    fi
    # 5) La cosecha: un usuario por DIRECTORIO de primer nivel, con el dueño de ese directorio.
    cosechar_usuarios "$KEEP_DIR" "$KEEP_USUARIOS"
    # 6) ¿Tiene espacio? Avisa y no aborta: un /home lleno es un problema del usuario, no un fallo
    #    de la instalación. Pero callarlo lo convierte en «el escritorio no arranca» la semana que viene.
    _kv_libre=$(df -m "$KEEP_DIR" 2>/dev/null | awk 'NR==2 {print $4}' || echo "")
    case "${_kv_libre:-}" in
        ''|*[!0-9]*) ;;
        *) [ "$_kv_libre" -lt 512 ] && echo "    ⚠ al /home conservado le quedan ${_kv_libre} MiB libres: el escritorio nuevo va a pelear por espacio." ;;
    esac
    keep_desmontar
}

keep_desmontar() {
    [ -n "$KEEP_MONTE_YO" ] || return 0
    umount "$KEEP_DIR" 2>/dev/null || echo "    ⚠ no pude desmontar $KEEP_DIR (sigo: sólo lo leí)." >&2
    KEEP_MONTE_YO=""
}

# keep_aplicar <árbol> — mete los usuarios y la declaración del montaje en la raíz NUEVA.
# Corre DESPUÉS de armar el árbol y ANTES del `mke2fs`: si algo falla acá, todavía no se destruyó nada.
keep_aplicar() {
    _ka_t="$1"
    usuarios_aplicar "$_ka_t" "$KEEP_USUARIOS"
    # 2) La declaración que lee el initramfs de pivote justo antes del switch_root.
    mkdir -p "$_ka_t/etc/takana"
    {
        echo "# Lo escribe 'takana metal install --keep' y lo lee el initramfs de pivote."
        echo "# Monta por HOME_UUID: el findfs de busybox NO entiende PARTUUID (medido)."
        echo "HOME_UUID=$KEEP_UUID"
        echo "HOME_PARTUUID=${KEEP_PARTUUID:-}"
        echo "HOME_DEV_AL_INSTALAR=$KEEP_DEV"
    } > "$_ka_t/etc/takana/home.conf"
    echo "    ✓ /home conservado declarado (UUID=$KEEP_UUID) — esa partición NO se formatea"
}

# ── El terreno, DICHO EN VOZ ALTA antes de tocar nada (ADR 0018 §4) ───────────────────────────
# `--keep` se valida ACÁ, antes de decir el plan: así el plan puede nombrar lo que se conserva y a
# quién se va a crear, y un /home que no monta aborta con el disco todavía intacto.
if [ -n "$KEEP_SPEC" ]; then
    keep_parsear
    echo "==> conservar: $KEEP_DEV → $KEEP_PUNTO   (NO se formatea)"
    keep_validar
fi
# `--adopt` se valida ACÁ por lo mismo que `--keep`: para que el plan pueda decir qué se mueve y a
# quién se va a crear, y para que un destino sin sistema adentro aborte con el disco todavía intacto.
if [ -n "$ADOPT" ]; then
    echo "==> adoptar: $DEST   (NO se formatea — el sistema de ahí se muda a un subdirectorio)"
    adopt_validar
fi
echo "==> destino: $DEST   ($( [ -b "$DEST" ] && echo 'partición real' || echo 'fichero de prueba'))"
if [ -b "$DEST" ] && command -v blkid >/dev/null 2>&1; then
    if [ -n "$ADOPT" ]; then
        echo "    lo que hay HOY ahí (NO se pierde: se mueve a /$ADOPT_SUB):"
    else
        echo "    lo que hay HOY ahí (se va a PERDER):"
    fi
    blkid "$DEST" 2>/dev/null | sed 's/^/      /' || echo "      (sin filesystem reconocible)"
fi
if [ -n "$ESP" ] && [ -b "$ESP" ] && [ -x "$HAMMER" ]; then
    _d="${DISK:-/dev/$(basename "$(readlink -f "/sys/class/block/$(nombre_kernel "$ESP")/..")")}"
    echo "    terreno de $_d (nada de esto se toca):"
    "$HAMMER" boot entry survey --disk "$_d" 2>&1 | sed 's/^/      /' || true
fi
if [ -n "$KEEP_SPEC" ]; then
    echo "    lo que se CONSERVA (no se formatea): $KEEP_DEV en $KEEP_PUNTO · UUID=$KEEP_UUID"
    if [ -s "$KEEP_USUARIOS" ]; then
        echo "    usuarios que voy a crear en el sistema nuevo, con el uid que ya tienen sus archivos:"
        while IFS=':' read -r _pl_n _pl_u _pl_g; do
            [ -n "$_pl_n" ] && printf "      · %s (uid %s, gid %s) → /home/%s\n" "$_pl_n" "$_pl_u" "$_pl_g" "$_pl_n"
        done < "$KEEP_USUARIOS"
        # Lo que NO se resuelve solo, dicho antes y no después: es la trampa 2 del pedido de churay,
        # y la instantánea de dotfiles que la desarma vive del lado de la suite, no acá.
        echo "    ⚠ los dotfiles del sistema viejo se conservan tal cual. Un .config de una app vieja"
        echo "      puede hacer que la app nueva arranque rota, y el síntoma no menciona el archivo."
    else
        echo "    (no encontré ningún usuario ahí: se conserva igual, montado en $KEEP_PUNTO)"
    fi
fi
if [ -n "$ADOPT" ]; then
    echo "    se MUEVE a /$ADOPT_SUB (sigue entero, no se copia ni se borra):"
    echo "      $ADOPT_MUEVE"
    echo "    se QUEDA donde está, con todos sus archivos: /home"
    if [ -s "$ADOPT_USUARIOS" ]; then
        echo "    usuarios que voy a crear en el sistema nuevo, con el uid que ya tienen sus archivos:"
        while IFS=':' read -r _pa_n _pa_u _pa_g; do
            [ -n "$_pa_n" ] && printf "      · %s (uid %s, gid %s) → /home/%s\n" "$_pa_n" "$_pa_u" "$_pa_g" "$_pa_n"
        done < "$ADOPT_USUARIOS"
        echo "    ⚠ los dotfiles del sistema viejo se conservan tal cual. Un .config de una app vieja"
        echo "      puede hacer que la app nueva arranque rota, y el síntoma no menciona el archivo."
    else
        echo "    (no hay ningún /home con usuarios adentro: se adopta igual)"
    fi
fi
if [ -z "$ASSUME_YES" ] && [ -t 0 ]; then
    if [ -n "$ADOPT" ]; then
        printf "    ¿muevo el sistema de %s a /%s e instalo encima, SIN formatear? [escribí si] " "$DEST" "$ADOPT_SUB"
    else
        printf "    ¿formateo %s y dejo el resto del disco INTACTO? [escribí si] " "$DEST"
    fi
    read -r _r; [ "$_r" = "si" ] || { echo "    cancelado."; exit 1; }
fi

# ── 1) Los árboles (initramfs de pivote + rootfs con su /sbin/init) los arma el script VALIDADO ──
# No se copian acá: se PIDEN. Ver el comentario de `STAGE_ONLY` en install-image-efi.sh.
STAGE="${STAGE:-work/.install-part-stage}"
# `STAGE_LISTO=1` — el árbol ya está armado y no hay que (ni se puede) rearmarlo. Es lo que usa el
# instalador cuando corre DENTRO de un initramfs: allí no hay repo, ni store, ni `install-image-efi.sh`;
# el stage viajó horneado en el propio initramfs. Se comprueba que esté completo, no se confía.
if [ -n "${STAGE_LISTO:-}" ]; then
    echo "==> stage ya armado: $STAGE (STAGE_LISTO=1)"
else
    echo "==> armando árboles (STAGE_ONLY sobre install-image-efi.sh)"
    STAGE_ONLY=1 KEEP_STORE=1 STAGE="$STAGE" ./scripts/install-image-efi.sh
fi
ROOT_TREE="$STAGE/root"; IRD="$STAGE/initramfs.cpio.gz"
[ -d "$ROOT_TREE" ] && [ -r "$IRD" ] || { echo "takana-install-partition: el stage no quedó completo" >&2; exit 1; }

# El /home conservado se declara en el ÁRBOL, antes de que el árbol entre al filesystem nuevo. Si
# hay un choque de uid, `keep_aplicar` aborta acá — con el destino todavía sin tocar.
if [ -n "$KEEP_SPEC" ]; then keep_aplicar "$ROOT_TREE"; fi
# El `/home` adoptado NO se declara en `home.conf`: no es otra partición que haya que montar, está
# dentro de la raíz. Lo único que hace falta es que sus dueños existan en el sistema nuevo.
if [ -n "$ADOPT" ] && [ -s "$ADOPT_USUARIOS" ]; then usuarios_aplicar "$ROOT_TREE" "$ADOPT_USUARIOS"; fi

# ── LA CUENTA: se pregunta acá y se escribe acá, con el destino TODAVÍA SIN TOCAR ─────────────────
# El orden importa en las dos direcciones. Después de `usuarios_aplicar`, para que un usuario ya
# cosechado del `/home` conservado sólo reciba su contraseña en vez de crearse dos veces (ése es el
# caso del operador: `sergio` existía con el uid de sus archivos y `!` por contraseña). Y antes del
# `mke2fs`, por el mismo motivo que `keep_aplicar`: si esto falla, nada se destruyó.
echo "══ la cuenta de quien va a usar la máquina ═══════════════════════════════════"
cuenta_preguntar "$ROOT_TREE"
cuenta_aplicar "$ROOT_TREE" \
    || { echo "takana-install-partition: la cuenta NO quedó escrita; no sigo y NADA se formateó." >&2; exit 1; }

# ── 2) Formatear SÓLO la partición destino, y poblarla SIN MONTARLA ────────────────────────────
# `mke2fs -d` escribe el árbol dentro del filesystem nuevo sin `mount` y sin loop. Que no haya
# montaje no es elegancia: un `mount` mal apuntado en un disco ajeno es justamente el accidente que
# este script existe para no tener. Si no somos root, `unshare -r` da los dueños root sin sudo.
if [ -n "$ADOPT" ]; then
echo "==> adoptando $DEST: el sistema anterior se muda y el nuevo se instala encima (NO se formatea)"
adopt_mudar "$ROOT_TREE"
else
echo "==> ext4 LABEL=hammer-root en $DEST (única escritura destructiva de todo el script)"
# ⚠ La detección de root NO puede fallar en silencio. Medido dentro del initramfs el 2026-09-23: sin
# el applet `id` el `$(id -u)` quedaba VACÍO, la comparación daba falso, el script se iba a la rama
# de `unshare` —que tampoco estaba— y **siguió adelante sin formatear nada**. Un `if` cuyo dato de
# entrada no existe elige una rama igual, y elige mal.
_uid=$(id -u 2>/dev/null || echo "")
[ -n "$_uid" ] || { echo "takana-install-partition: no hay 'id' en este entorno y no puedo saber si soy root" >&2; exit 1; }
if [ "$_uid" = "0" ]; then
    "$MKE2FS" -q -t ext4 -L hammer-root -d "$ROOT_TREE" "$DEST"
else
    command -v unshare >/dev/null 2>&1 || {
        echo "takana-install-partition: no soy root (uid $_uid) y no hay 'unshare' para suplirlo" >&2; exit 1; }
    unshare -r "$MKE2FS" -q -t ext4 -L hammer-root -d "$ROOT_TREE" "$DEST"
fi
fi
# Y no se da por hecho: se mira. Regla 3 del CLAUDE.md — un ausente falla ruidosamente, un vacío
# llega hasta el final diciendo que todo fue bien. Acá el vacío sería un destino sin filesystem.
# ⚠ La verificación tiene que funcionar con LOS DOS `blkid`, y la primera versión no lo hacía:
# `-s LABEL -o value` es de util-linux y **busybox lo ignora**, devolviendo la línea entera
# (`/dev/vda2: LABEL="hammer-root" UUID=…`). Resultado medido en QEMU: el formateo había salido
# PERFECTO y el guardián abortó igual, con un mensaje que mostraba la label correcta dentro del
# texto de «no quedó con LABEL». Tercer caso hoy del mismo patrón: un chequeo que valida algo
# distinto de lo que cree validar acusa al inocente, y un guardián así se desactiva a la semana.
# ⚠ Y el patrón tiene que distinguir `LABEL` de **`PARTLABEL`**, que es otra cosa: el primero es la
# etiqueta del FILESYSTEM y el segundo el nombre de la ENTRADA GPT. Con `sed 's/.*LABEL="…"/'` el
# `.*` es glotón y se come el «PART», así que devolvía el nombre de la partición en la tabla
# («destino-takana») y el guardián abortaba una instalación correcta. Segunda vez que este mismo
# chequeo acusa al inocente por mirar mal el dato. El espacio de ` LABEL="` es lo que los separa.
_lbl_post=$(blkid "$DEST" 2>/dev/null | grep -o ' LABEL="[^"]*"' | head -1 | sed 's/^ LABEL="//; s/"$//')
[ -n "$_lbl_post" ] || _lbl_post=$(blkid -s LABEL -o value "$DEST" 2>/dev/null || true)
[ "$_lbl_post" = "hammer-root" ] || {
    echo "takana-install-partition: $DEST NO quedó con LABEL=hammer-root (blkid dice '${_lbl_post:-nada}')." >&2
    echo "                          El formateo no se completó: no sigo." >&2; exit 1; }
if [ -n "$ADOPT" ]; then
    echo "    ✓ $DEST adoptada y poblada (LABEL=hammer-root verificada) — el sistema anterior en /$ADOPT_SUB"
else
    echo "    ✓ $DEST formateada y poblada (LABEL=hammer-root verificada)"
fi

# ── 3) La ESP: sólo nuestra carpeta de vendor, con mtools y SIN montar ─────────────────────────
if [ -n "$ESP" ]; then
    # ⚠ **mtools puede QUEDARSE ESPERANDO UNA RESPUESTA, y colgado es indistinguible de lento.**
    # Medido en QEMU el 2026-09-23: sobre `/dev/vda1` el instalador se detuvo para siempre justo
    # después de imprimir el espacio libre, sin una línea más. Dos defensas, porque una sola tapa el
    # síntoma sin quitar la causa:
    #   · `MTOOLS_SKIP_CHECK=1` desactiva el chequeo de geometría, que es lo que hace preguntar
    #     cuando el device no se parece a un disquete;
    #   · `< /dev/null` en cada invocación, para que una pregunta que igual aparezca FALLE en vez de
    #     esperar. Un error se lee; un cuelgue en un instalador parece un sistema muerto.
    export MTOOLS_SKIP_CHECK=1
    "$MDIR" -i "$ESP" :: >/dev/null 2>&1 < /dev/null || { echo "takana-install-partition: $ESP no parece FAT (¿es la ESP?)" >&2; exit 1; }
    # Guardián de capacidad: una ESP de fábrica son 100 MiB y Windows ya vive ahí. El margen se
    # comprueba ANTES, con los números a la vista, no como un «disk full» a mitad de copiar.
    # ⚠ `mdir` imprime el espacio libre con SEPARADOR DE MILES en espacios («60 056 064 bytes
    # free»), así que tomar `$1` devuelve **60** y el guardián aborta una instalación perfectamente
    # posible. Medido en la primera corrida de este script. Hay que juntar los dígitos de la línea.
    _free=$("$MDIR" -i "$ESP" :: 2>/dev/null < /dev/null | awk '/bytes free/ {l=$0; sub(/ bytes free.*/,"",l); gsub(/[^0-9]/,"",l); print l}' | tail -1)
    _need=$(( $(wc -c < "$KERNEL") + $(wc -c < "$IRD") ))
    [ -n "${_free:-}" ] && [ "$_free" -lt "$_need" ] && {
        echo "takana-install-partition: la ESP tiene ${_free}B libres y hacen falta ${_need}B." >&2
        echo "                          No se escribió nada en ella." >&2; exit 1; }
    # ⚠ **Un FAT puede declarar MÁS espacio del que su partición tiene, y nadie se queja hasta que
    # una escritura grande cae más allá del final.** Medido acá el 2026-09-23 fabricando el disco de
    # prueba: `mformat -i disco.img@@<offset>` formatea usando el tamaño del FICHERO ENTERO, no el de
    # la partición ⇒ una ESP de 64 MiB con un FAT que anuncia 2,5 G. Y no es un artefacto del banco de
    # pruebas: cualquier ESP que alguien encogió con una herramienta de particionado sin reformatear
    # queda igual. El `df` del kernel repite la mentira —la leyó del mismo sector de arranque— así que
    # NO alcanza con preguntarle al filesystem: hay que contrastar contra el TAMAÑO REAL del
    # contenedor, que es lo único que no puede mentir.
    if [ -b "$ESP" ]; then
        _cap=$(blockdev --getsize64 "$ESP" 2>/dev/null || echo "")
        [ -z "$_cap" ] && _cap=$(( $(cat "/sys/class/block/$(nombre_kernel "$ESP")/size" 2>/dev/null || echo 0) * 512 ))
    else
        _cap=$(wc -c < "$ESP")
    fi
    if [ -n "${_free:-}" ] && [ "${_cap:-0}" -gt 0 ] && [ "$_free" -gt "$_cap" ]; then
        echo "    ! el FAT de $ESP dice ${_free}B libres pero la partición mide ${_cap}B: el filesystem" >&2
        echo "      declara más espacio del que existe (ESP encogida sin reformatear, o formateada" >&2
        echo "      sobre un contenedor mayor). Uso el tamaño REAL como cota." >&2
        _free="$_cap"
    fi
    echo "==> ESP $ESP: \\EFI\\takana\\ (${_need}B sobre ${_free:-?}B libres)"
    "$MMD" -i "$ESP" ::/EFI 2>/dev/null < /dev/null || true
    "$MMD" -i "$ESP" ::/EFI/takana 2>/dev/null < /dev/null || true
    "$MCOPY" -o -i "$ESP" "$KERNEL" ::/EFI/takana/takanax64.efi < /dev/null
    "$MCOPY" -o -i "$ESP" "$IRD"    ::/initramfs.cpio.gz < /dev/null
    # La ruta fallback es tierra de nadie: si YA hay algo, es de otro sistema y no se pisa sin que
    # el usuario lo pida. Si no hay nada, ocuparla es gratis y salva el caso «el firmware ignora la
    # entrada NVRAM», que es el modo de fallo más común y el más difícil de diagnosticar.
    if "$MDIR" -i "$ESP" ::/EFI/BOOT/BOOTX64.EFI >/dev/null 2>&1 < /dev/null; then
        if [ -n "$CLAIM_FALLBACK" ]; then
            "$MCOPY" -o -i "$ESP" "$KERNEL" ::/EFI/BOOT/BOOTX64.EFI < /dev/null
            echo "    ! \\EFI\\BOOT\\BOOTX64.EFI PISADO (--claim-fallback)"
        else
            echo "    · \\EFI\\BOOT\\BOOTX64.EFI ya existe y es de otro: NO se toca (--claim-fallback para pisarlo)"
        fi
    else
        "$MMD" -i "$ESP" ::/EFI/BOOT 2>/dev/null < /dev/null || true
        "$MCOPY" -o -i "$ESP" "$KERNEL" ::/EFI/BOOT/BOOTX64.EFI < /dev/null
        echo "    + \\EFI\\BOOT\\BOOTX64.EFI estaba libre ⇒ ocupada (arranca sin depender de la NVRAM)"
    fi
    for _p in ::/EFI/takana/takanax64.efi ::/initramfs.cpio.gz; do
        "$MDIR" -i "$ESP" "$_p" >/dev/null 2>&1 < /dev/null || { echo "takana-install-partition: falta $_p en la ESP" >&2; exit 1; }
    done
    echo "    ✓ ESP poblada y verificada (sin montarla)"
else
    echo "    ! sin --esp: el sistema queda instalado pero NO arrancable todavía"
fi

# ── 4) La entrada de arranque: convivir con el vecino, con respaldo previo ─────────────────────
if [ -z "$NO_NVRAM" ] && [ -n "$ESP" ] && [ -b "$ESP" ] && [ -d /sys/firmware/efi/efivars ] && [ -x "$HAMMER" ]; then
    if [ -z "$DISK" ] || [ -z "$ESP_PART" ]; then
        _en=$(nombre_kernel "$ESP")
        DISK="${DISK:-/dev/$(basename "$(readlink -f "/sys/class/block/$_en/..")")}"
        ESP_PART="${ESP_PART:-$(cat "/sys/class/block/$_en/partition" 2>/dev/null || echo 1)}"
    fi
    echo "==> respaldo del arranque ANTES de tocar la NVRAM (ADR 0018 §5)"
    "$HAMMER" boot entry backup || echo "    ! el respaldo falló — seguí sólo si sabés por qué" >&2
    echo "==> entrada NVRAM: $DISK p$ESP_PART → \\EFI\\takana\\takanax64.efi"
    "$HAMMER" boot entry add --disk "$DISK" --partition "$ESP_PART" --loader '/EFI/takana/takanax64.efi'
else
    echo "    · NVRAM no tocada (--no-nvram, sin efivarfs, o destino de prueba)"
fi

if [ -n "$USE_FREE" ]; then
    echo "✓ takana instalada en $DEST, una partición NUEVA creada en espacio sin asignar."
    echo "  La tabla creció en una entrada; ninguna de las que ya estaban se modificó."
else
    echo "✓ takana instalada en $DEST. La tabla de particiones NO se tocó y las demás particiones siguen como estaban."
fi
echo "  Comprobalo antes de reiniciar:  lsblk -o NAME,SIZE,FSTYPE,LABEL  ·  $HAMMER boot entry list"