Files
takana/recipes/incoming-kde/kirigami.toml
T
Sergio 44b3624de6 kirigami: arreglado el no-determinismo — eran DOS causas, y ahora reproduce bit a bit
Antes: dos reconstrucciones con las mismas entradas y el mismo lab daban artefactos
distintos. Ahora: `why-differs` da 464 entradas idénticas · 0 divergen.

Hash: 41eea38e… → a72b1626… (arrastra 37 dependientes directos, 39 transitivos).

── CAUSA 1: el AOT de QML compilaba un conjunto DISTINTO de funciones cada vez ─────────
`libKirigamiTemplates.so` cambiaba de tamaño (5.737.344 vs 5.795.072) y difería en 177
símbolos locales, todos `QmlCacheGeneratedCode…__invoke` y concentrados en CUATRO ficheros:
InlineMessage, LinkButton, NavigationTabBar y Badge.

Y esos cuatro son justo los que importan módulos QML HERMANOS del propio proyecto
(`org.kde.kirigami.platform`, `.primitives`, `.controls`). `qmlcachegen` sólo compila a AOT
lo que puede resolver de tipos, y los tipos del hermano salen de su `.qmltypes`, que produce
otro objetivo del mismo build. `src/templates/CMakeLists.txt` no declara `DEPENDENCIES`
ninguna ⇒ con ninja en paralelo es una CARRERA.

Control que sostiene el diagnóstico: `Chip` y `Heading`, del mismo directorio, no divergen —
y `kirigami-addons` y `kquickcharts`, que también llevan QML, reproducen. No es «QML es
no-determinista».

Arreglo: `-j1` en el compile. Orden topológico fijo ⇒ el cachegen ve siempre lo mismo.
NO es throttling (eso va por nice/taskset justamente para no re-hashear): es corrección, y
el re-hash es el precio que se paga a propósito.

Descartadas, con motivo: `-DQT_QML_NO_CACHEGEN=ON` apaga también el bytecode precompilado
(coste de arranque en el escritorio); `--only-bytecode` sería lo quirúrgico pero
`QT_QMLCACHEGEN_ARGUMENTS` es propiedad de objetivo y NO es INHERITED, así que no hay forma
de ponerla desde la línea de órdenes.

── CAUSA 2: el .tar.bz2 de plantillas se armaba sin orden ──────────────────────────────
`kde_package_app_templates` de ECM tiene camino reproducible —`--sort=name --mtime=@
SOURCE_DATE_EPOCH --numeric-owner --owner=0 --group=0`— pero detrás de `if(GNU_TAR_FOUND)`,
que exige que `tar --version` diga «GNU tar». El rootfs del lab es Alpine: `tar` es BUSYBOX
⇒ caía al respaldo `cmake -E tar cvfj`, que ni ordena ni normaliza. El orden lo ponía readdir.

Arreglo: `tar` (GNU tar 1.35, ya en el corpus) entra en `[deps] build`.

Comprobado mirando el artefacto, no deducido:

    drwxr-xr-x 0/0  1970-01-01 00:00 ./
    -rw-r--r-- 0/0  1970-01-01 00:00 ./CMakeLists.txt
    -rw-r--r-- 0/0  1970-01-01 00:00 ./LICENSES/BSD-3-Clause.txt

owner 0/0, mtime al epoch (SOURCE_DATE_EPOCH=1 lo fija el sandbox) y la lista ORDENADA.
2026-09-14 16:40:35 +00:00

99 lines
6.1 KiB
TOML

# kirigami 6.27.0 — KDE Frameworks 6 (tier-4, ADR 0011). Toolkit QML de KDE (UI Plasma Mobile/Desktop).
# Tarball 6.27 se llama "kirigami" (ya no kirigami2). Precursor QML-pesado de Plasma.
# CMakeLists: find_package(Qt6 REQUIRED Core Quick Gui Svg QuickControls2 Concurrent ShaderTools).
# Quick+QuickControls2 → qtdeclarative (en Qt6 QtQuickControls2 vive en el repo qtdeclarative).
# Svg → qtsvg. ShaderTools (qsb) → qtshadertools. Core/Gui/Concurrent/DBus → qtbase.
# CERO deps KF6 (el único find_package(KF6Kirigami) es auto-referencia en examples, OFF). Sin option(WITH_X11).
# USE_DBUS ON por defecto en Linux → Qt6DBus (qtbase). BUILD_EXAMPLES OFF por defecto. DESKTOP_ENABLED ON.
#
# ══ ⚠ ESTA RECETA ERA NO-DETERMINISTA, Y SE ARREGLÓ EL 2026-09-14 (SDD 23) ═══════════════════════
# Medido, no sospechado: dos reconstrucciones seguidas con las MISMAS entradas y el MISMO lab daban
# artefactos distintos. Eran dos causas independientes, y cada una tiene su arreglo abajo.
#
# ── CAUSA 1: el AOT de QML compilaba un CONJUNTO DISTINTO de funciones en cada corrida ───────────
# `libKirigamiTemplates.so` cambiaba de tamaño (5.737.344 contra 5.795.072 bytes) y difería en 177
# símbolos locales, todos `QmlCacheGeneratedCode…__invoke`, concentrados en CUATRO ficheros QML:
# InlineMessage, LinkButton, NavigationTabBar y Badge. No es que los símbolos se renumeren: es que
# una corrida compila a AOT funciones que la otra no.
#
# Y esos cuatro son exactamente los que importan MÓDULOS QML HERMANOS del propio proyecto
# (`org.kde.kirigami.platform`, `.primitives`, `.controls`). `qmlcachegen` sólo compila a AOT lo que
# puede resolver de tipos, y los tipos de un módulo hermano salen de su `.qmltypes`, que lo produce
# OTRO objetivo del mismo build. `src/templates/CMakeLists.txt` no declara `DEPENDENCIES` ninguna
# ⇒ con ninja en paralelo, que el `.qmltypes` del hermano exista cuando corre el cachegen de
# templates es una CARRERA. Se gana o se pierde según el planificador, y el artefacto sale distinto.
#
# Arreglo: `-j1` en el compile. Con ninja serial el orden es un topológico FIJO ⇒ el cachegen ve
# siempre el mismo estado y compila siempre el mismo conjunto.
#
# ⚠ Esto NO contradice la regla de «el paralelismo no se capa en la receta». Esa regla es sobre
# THROTTLING por recursos —que va por `nice`/`taskset` justamente para no re-hashear—; acá el `-j`
# es CORRECCIÓN, y el re-hash es el precio que se decidió pagar (arrastra 37 dependientes).
#
# ⚠ Las alternativas se miraron y se descartaron, con el motivo:
# · `-DQT_QML_NO_CACHEGEN=ON` — determinista y rápido, pero apaga TAMBIÉN el bytecode precompilado
# de todo el QML de Kirigami: eso es coste de arranque en el escritorio, no de build.
# · `--only-bytecode` por objetivo — sería lo quirúrgico (conserva bytecode, tira sólo el AOT),
# pero `QT_QMLCACHEGEN_ARGUMENTS` es propiedad DE OBJETIVO y no es INHERITED, así que no hay
# forma de ponerla desde la línea de órdenes; haría falta parchear los 9 subdirectorios.
# · declarar `DEPENDENCIES` en templates — es lo correcto aguas arriba, pero `controls` importa
# `templates` y `templates` importa `controls`: el ciclo hay que resolverlo con cuidado y eso
# es trabajo de upstream, no de esta receta.
#
# ── CAUSA 2: el `.tar.bz2` de plantillas se armaba SIN ORDEN ─────────────────────────────────────
# `usr/share/kdevappwizard/templates/kirigami6.tar.bz2` difería desde el byte 0xa, o sea desde el
# primer bloque comprimido. El macro `kde_package_app_templates` de ECM SÍ tiene camino reproducible
# —`--sort=name --mtime=@$SOURCE_DATE_EPOCH --numeric-owner --owner=0 --group=0`— pero está detrás
# de un `if(GNU_TAR_FOUND)`, y esa comprobación corre `tar --sort=name --version` y exige que diga
# «GNU tar». El rootfs del lab es Alpine: `tar` es BUSYBOX ⇒ la comprobación falla ⇒ cae al camino
# de respaldo `cmake -E tar cvfj`, que ni ordena ni normaliza mtime/owner. El orden lo ponía el
# readdir.
#
# Arreglo: `tar` (GNU tar 1.35, ya en el corpus) entra en `[deps] build`. Con él en el overlay la
# comprobación de ECM pasa y se toma el camino reproducible. `SOURCE_DATE_EPOCH` ya lo fija el
# sandbox (=1), así que el `--mtime` queda pineado sin tocar nada más.
#
# Comprobación: `scripts/verificar-repro.sh` sobre esta receta — dos reconstrucciones IDÉNTICAS.
name = "kirigami"
version = "6.27.0"
license = "LGPL-2.1-or-later OR LGPL-3.0-or-later"
[source]
tarball = "https://download.kde.org/stable/frameworks/6.27/kirigami-6.27.0.tar.xz"
sha256 = "d7daa74e9fe81b674e54e6e979feb85d3d2f4216bf6d9c02bfaa2c021fe1ac2d"
[build]
compiler = "zig-cc"
target = "x86_64-linux-musl"
link = "dynamic"
flags = []
[build.phases]
configure = '''
ZW="$PWD/.zwrap"; mkdir -p "$ZW"
cat > "$ZW/cc" <<'W'
#!/bin/sh
a=""; for x in "$@"; do [ "$x" = "-Wl,--fatal-warnings" ] && continue; a="$a $x"; done
exec /opt/zig/zig cc -mcpu=baseline $a
W
cat > "$ZW/cxx" <<'W'
#!/bin/sh
a=""; for x in "$@"; do [ "$x" = "-Wl,--fatal-warnings" ] && continue; a="$a $x"; done
exec /opt/zig/zig c++ -mcpu=baseline $a
W
chmod +x "$ZW/cc" "$ZW/cxx"
cmake -B build -G Ninja -Wno-dev \
-DCMAKE_C_COMPILER="$ZW/cc" -DCMAKE_CXX_COMPILER="$ZW/cxx" -DCMAKE_ASM_COMPILER="$ZW/cc" \
-DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_PREFIX_PATH=/usr \
-DCMAKE_INTERPROCEDURAL_OPTIMIZATION=OFF \
-DBUILD_TESTING=OFF -DBUILD_PYTHON_BINDINGS=OFF -DBUILD_EXAMPLES=OFF
'''
# ⚠ `-j1` NO es throttling: es lo que hace determinista el AOT de QML. Ver la cabecera.
compile = "cmake --build build -j1"
install = "DESTDIR=/out cmake --install build"
[deps]
# `tar` = GNU tar. NO es un capricho: sin él, ECM no reconoce un tar GNU y arma el .tar.bz2 de
# plantillas por el camino NO reproducible. Ver la cabecera, causa 2.
build = ["cmake", "samurai", "python3", "pkgconf", "qtbase", "dbus", "extra-cmake-modules", "qttools", "mesa", "libdrm", "libxkbcommon", "wayland", "qtdeclarative", "qtsvg", "qtshadertools", "tar"]