sergio/takana

1# targets.toml — el MANIFIESTO DE OBJETIVO: qué paquetes debe tener la distro.
2#
3# POR QUÉ EXISTE. `build-state.json` es el grafo de lo que EXISTE (768 recetas, cierra sin huérfanas).
4# Lo que la distro DEBE tener no estaba en ningún lado: vivía en dos strings de shell de
5# `product-userland-from-repo.sh`, otro de `mirada-usb.sh`, 55 listas planas en `tandas/` y una cola
6# de 206 recetas KDE. Por eso "¿cuánto falta?" no tenía respuesta: el mapa cerraba perfecto, pero
7# sólo cubría el territorio ya conquistado. Este fichero es el destino. (Plan: docs/plan-catalogo-objetivo.md)
8#
9# LA INVERSIÓN. `paquetes` lista sólo las RAÍCES — lo que un usuario pide POR NOMBRE. La clausura
10# (las libs de las que cuelgan) la calcula el grafo siguiendo las aristas de deps, no la escribe un
11# humano. Al revés de `tandas/base-system-3-libs.txt`, que enumera a mano miembros de la clausura.
12#
13# Un `perfil` = una imagen enviable. `hereda` compone (transitivo, sin ciclos). `cola` dice en qué
14# árbol de recetas viven sus raíces: `corpus` = `recipes/`; otra cosa = `recipes/incoming-<x>/`, que
15# `build-state.py` sólo carga con su flag (`--kde`) ⇒ los perfiles de una cola no cargada se saltan
16# en vez de reportar raíces fantasma.
17#
18# Consumidores: `scripts/targets.py <perfil>` (expande a lista de nombres) y `scripts/build-state.py`
19# (marca los nodos `wanted` y calcula la membresía de perfil de cada receta).
20schema = "hammer-targets/1"
21
22[perfil.base]
23descripcion = "userland foundational C: la distro arranca y se usa (shell, VCS, privilegios, red, disco, TLS, proceso, editor, docs)"
24# Lift verbatim de BASE_SYSTEM_PKGS (scripts/product-userland-from-repo.sh). De-Alpinizado y firmado,
25# tandas base-system-1..3.
26paquetes = [
27  "bash", "git", "sudo", "doas", "util-linux", "shadow", "kbd", "procps-ng",
28  "iproute2", "iputils", "dhcpcd", "e2fsprogs", "dosfstools", "parted", "rsync",
29  "sed", "tzdata", "vim", "dbus", "ca-certificates", "gnupg", "lsof", "strace",
30  "pciutils", "usbutils", "mandoc",
31]
32
33[perfil.cli]
34descripcion = "la capa CLI moderna (Rust) encima de base — el userland real del producto"
35hereda = ["base"]
36# Lift verbatim de CLI_RUST_PKGS (scripts/product-userland-from-repo.sh).
37paquetes = [
38  "bat", "fd", "ripgrep", "jq", "zoxide", "dust", "procs", "htop", "less", "tree",
39  "hyperfine", "delta", "eza", "sd", "tokei", "fzf", "skim", "git-cliff", "gitui",
40  "starship",
41]
42
43[perfil.escritorio-mirada]
44descripcion = "rootfs slim del USB mirada: compositor Wayland propio sobre mesa software"
45# Lift verbatim de PKGS (scripts/mirada-usb.sh). NO hereda base: es una imagen slim a propósito.
46# El ORDEN importa (libs primero, binarios mirada al final) y se preserva.
47paquetes = [
48  "mesa-swrast", "wayland", "libdrm", "seatd", "libinput", "libudev-zero",
49  "libxkbcommon", "pixman", "linux-pam", "mtdev", "libevdev",
50  "mirada-compositor", "mirada-greeter", "mirada-ctl",
51]
52
53[perfil.escritorio-kde]
54descripcion = "escritorio KDE Plasma 6 desde fuente"
55cola = "incoming-kde"
56# Raíces del rootfs de metal (docs/HANDOFF-noche-kde-2026-07-14.md:135). El resto del escritorio
57# —137 artefactos hidratados— es CLAUSURA de estas 7, no lista a mano.
58paquetes = [
59  "plasma-workspace", "kwin", "kscreenlocker", "breeze", "frameworkintegration",
60  "qqc2-desktop-style", "plasma-integration",
61  # Huecos de RUNTIME confirmados por el triaje de la frontera (2026-07-22). Ninguno bloquea un
62  # build —todas las recetas que los piden ya están selladas— pero sin ellos el escritorio arranca
63  # roto: sin tipos de fichero, sin apps X11, sin diálogos de autorización y con los controles QML
64  # en un estilo genérico. Ver docs/state/frontera-triaje.toml para el porqué de cada uno.
65  "shared-mime-info", "xwayland", "polkit-qt-1", "qqc2-breeze-style",
66  # ── FUENTES ──────────────────────────────────────────────────────────────────────────────────
67  # Añadida el 2026-09-03 por el mismo recuento que destapó el hueco de GNOME: contando
68  # `.ttf/.otf/.ttc/.pfb` sobre los artefactos del cierre, este perfil tenía **UNA sola**, y de
69  # rebote — viene dentro de `qtbase`, no porque nadie la haya pedido. `fontconfig` estaba, pero
70  # fontconfig es el MOTOR que busca fuentes, no una fuente.
71  # Depender de la que trae qtbase es apoyarse en un detalle de empaquetado de Qt que puede
72  # desaparecer en cualquier versión, y encima deja a todo lo que NO es Qt sin nada.
73  "dejavu-fonts",
74  # `dejavu-fonts-nerd` es la MISMA DejaVu Sans Mono parcheada con Nerd Fonts (~10.000 glifos de
75  # iconos: Powerline, Font Awesome, Devicons…) que usan starship, lsd, eza, neovim y las
76  # statuslines; sin ellos dibujan cuadraditos. Se AÑADE, no reemplaza: la licencia de Bitstream
77  # Vera obliga a renombrar una fuente modificada, así que la parcheada se llama
78  # «DejaVuSansM Nerd Font Mono» y NO puede responder a «DejaVu Sans Mono» — sustituirla rompería
79  # a todo lo que la pide por nombre, empezando por foot. Se enchufa por fontconfig: su
80  # `59-nerd-monospace.conf` hace que el alias `monospace` la prefiera. Ver su receta.
81  "dejavu-fonts-nerd",
82  # ⚠ `xwayland` sigue acá como RAÍZ pero su receta NO se va a escribir: lo provee una imagen ajena
83  # enjaulada, declarado en ../state/qorpa-ajenos.toml (ADR 0015 D5 capa 3, qorpa). El Xwayland vive
84  # DENTRO de la imagen —Arch y Fedora ya lo traen y se cuelga de kwin por el socket— así que el
85  # hueco se disuelve sin receta y sin tocar la postura Wayland-only. Queda como raíz A PROPÓSITO:
86  # la imagen lo NECESITA, y sacarlo de acá lo volvería invisible en vez de contado aparte. El grafo
87  # ya lo reporta con clase `ajeno` («+ 1 ajenas»), nunca sumado a las nativas. Los otros tres ya
88  # están sellados (2026-09-02/03).
89  # ── LA PRIMERA APP DE USUARIO FINAL QUE COMPARTEN LOS CUATRO ESCRITORIOS ──────────────────────
90  # `mpv` vive en el CORPUS, no en esta cola, justamente para poder listarse en las cuatro: una
91  # receta resuelve sibling-first y después el catálogo padre, así que desde acá se alcanza.
92  # Va de raíz por la lección que este mismo fichero ya aprendió con `foot` en el perfil de sway:
93  # una receta sellada que ningún perfil declara NO ESTÁ EN NINGUNA IMAGEN, y la métrica de
94  # clausura no lo puede ver porque mide lo declarado. Sellado ≠ instalado.
95  # ⚠ Hoy entra con tres huecos escritos en `recipes/mpv.toml`: audio por ALSA con
96  # `-Dpipewire-alsa=disabled` en las pipewire (⇒ no suena con PipeWire vivo), sin Lua (⇒ sin OSC)
97  # y sin vaapi (⇒ sin decodificación por hardware).
98  "mpv",
99  # ── VISOR DE IMÁGENES, TAMBIÉN EN LAS CUATRO ─────────────────────────────────────────────────
100  # `swayimg` y no `imv`, que era lo que proponía `docs/plan-apps-usuario-final.md`: imv dibuja con
101  # OpenGL de función fija (`glBegin`/`glOrtho`) y esta distro NO tiene proveedor de GL de
102  # escritorio — las tres mesa van `-Dglx=disabled -Dglvnd=false` ⇒ no hay `libGL.so` ni `gl.pc` en
103  # ninguna cola. swayimg rasteriza a `wl_shm` y no toca GL; el porqué largo está en su receta.
104  # Trae de yapa backend DRM: muestra imágenes en una TTY pelada, sin compositor.
105  "swayimg",
106  # ── LAS `.so` QUE mesa Y wayland PIDEN EN RUNTIME Y NINGÚN ARTEFACTO DEL CIERRE PROVEE ────────
107  # Medido el 2026-09-03 recorriendo los NEEDED de todo el cierre de esta imagen contra los SONAME
108  # que ese mismo cierre publica: `libEGL.so.1` pide `libexpat.so.1` y `libwayland-client.so.0` pide
109  # `libffi.so.8`, y las recetas canónicas de expat y libffi son `--disable-shared`. O sea que el
110  # rootfs hidratado los resolvía contra el **sysroot Alpine DEL LAB**.
111  # Es peor que una dep faltante: el lab NO entra en `hash_inputs`, así que la fuga es invisible para
112  # el store — el artefacto se da por bueno y sólo arranca en una máquina con Alpine debajo.
113  # No es un descubrimiento nuevo: es EXACTAMENTE lo que el perfil `escritorio-sway` ya documentó
114  # para `sway`, sólo que ahí se encontró a mano al armar la imagen y estas tres nunca se revisaron.
115  # Van de raíces (y no de `[deps]`) por lo mismo que las fuentes y el XKB: son data de RUNTIME y
116  # nadie las declara como dep de BUILD, así que la clausura no puede alcanzarlas por ninguna arista.
117  # `bzip2-shared` se suma el 2026-09-03, cazada por `scripts/vigia-sonames.py` en los TRES perfiles
118  # a la vez: `freetype-shared` sale con `NEEDED libbz2.so.1` y el `bzip2` canónico del corpus es
119  # `.a`. Es la misma fuga al sysroot del lab que expat y libffi, y venía de antes que zathura —
120  # sólo que hasta ahora nadie cargaba freetype-shared en RUNTIME. Se vio de verdad al probar el
121  # visor: el plugin de PDF no hacía dlopen («Error relocating /usr/lib/libbz2.so.1»). La receta
122  # existía sólo en `incoming-kde`; promovida al corpus con el mismo hash (b3:1e404254 desde las dos
123  # partes ⇒ un solo artefacto, cero rebuilds).
124  "expat-shared", "libffi-shared", "bzip2-shared",
125]
126
127[perfil.escritorio-gnome]
128descripcion = "escritorio GNOME (Wayland-nativo) desde fuente — 3er escritorio, X11 al tacho"
129cola = "incoming-gnome"
130# Raíces de una sesión GNOME que bootea a un shell usable. El resto es CLAUSURA. Hoy son HUECOS
131# (cero recetas en incoming-gnome): build-state SALTA este perfil hasta que su cola se cargue
132# (--gnome), así que declararlo NO reporta raíces fantasma — sólo lo hace un objetivo de primera
133# clase que el sistema conoce. La frontera de autoría se descubre con `seed-gnome.py` (bootstrap por
134# metadata mientras no haya recetas); OJO: ese cierre SOBREESTIMA ~5-10× (ver docs/state/seed-gnome.json
135# y la memoria frente-gnome). El palo largo / keystone es spidermonkey(mozjs) → gjs → gnome-shell.
136#
137# ── SIN gnome-session / gnome-settings-daemon / gdm: APARCADAS POR DISEÑO (2026-08-07) ───────────
138# Estaban acá y hacían que el perfil reportara 124/127 con 3 en `never` PARA SIEMPRE, que se lee
139# como trabajo pendiente. No lo es: las tres mueren en GTK3, y GTK3 es una de las tres deudas que
140# el frente GNOME aparcó a propósito (GTK3 / X11 / PAM). El diagnóstico completo, verificado contra
141# el `meson.build` de cada tag, está en el encabezado de cada receta — que sigue en el repo, con su
142# análisis intacto, por si algún día se autora el stack GTK3.
143#
144# NO son tres problemas, es UNO. Y no bloquean el escritorio: gnome-shell NO depende de
145# gnome-session ni de g-s-d, ni en build ni para arrancar. El camino vivo es mutter → gnome-shell,
146# lanzado por arje. El único que pedía gnome-session era gdm.
147#
148# ⚠ La contradicción costó: `targets.toml` las reclamaba como raíces mientras las recetas decían
149# «aparcadas», así que el grafo reportaba deuda fantasma y el worker las reintentaba en cada ciclo.
150# Dos documentos del repo diciendo cosas opuestas, y el que se mira primero es el grafo.
151# Si algún día se autora GTK3, se vuelven a añadir acá y el objetivo reaparece solo.
152paquetes = [
153  "mutter", "gnome-shell", "gjs",
154  "gsettings-desktop-schemas", "gnome-desktop", "xdg-desktop-portal-gnome",
155  # ── LA PRIMERA APP DE USUARIO FINAL QUE COMPARTEN LOS CUATRO ESCRITORIOS ──────────────────────
156  # `mpv` vive en el CORPUS, no en esta cola, justamente para poder listarse en las cuatro: una
157  # receta resuelve sibling-first y después el catálogo padre, así que desde acá se alcanza.
158  # Va de raíz por la lección que este mismo fichero ya aprendió con `foot` en el perfil de sway:
159  # una receta sellada que ningún perfil declara NO ESTÁ EN NINGUNA IMAGEN, y la métrica de
160  # clausura no lo puede ver porque mide lo declarado. Sellado ≠ instalado.
161  # ⚠ Hoy entra con tres huecos escritos en `recipes/mpv.toml`: audio por ALSA con
162  # `-Dpipewire-alsa=disabled` en las pipewire (⇒ no suena con PipeWire vivo), sin Lua (⇒ sin OSC)
163  # y sin vaapi (⇒ sin decodificación por hardware).
164  "mpv",
165  # ── VISOR DE IMÁGENES, TAMBIÉN EN LAS CUATRO ─────────────────────────────────────────────────
166  # `swayimg` y no `imv`, que era lo que proponía `docs/plan-apps-usuario-final.md`: imv dibuja con
167  # OpenGL de función fija (`glBegin`/`glOrtho`) y esta distro NO tiene proveedor de GL de
168  # escritorio — las tres mesa van `-Dglx=disabled -Dglvnd=false` ⇒ no hay `libGL.so` ni `gl.pc` en
169  # ninguna cola. swayimg rasteriza a `wl_shm` y no toca GL; el porqué largo está en su receta.
170  # Trae de yapa backend DRM: muestra imágenes en una TTY pelada, sin compositor.
171  "swayimg",
172  # ── LECTOR DE DOCUMENTOS ─────────────────────────────────────────────────────────────────────
173  # ⚠ NO ESTÁ EN `escritorio-kde`, y no es un olvido. `zathura-pdf-poppler` necesita `poppler-glib`,
174  # que es una receta NUEVA del corpus (la que ya existía va `-DENABLE_GLIB=OFF` y vive en la cola
175  # de KDE). Las dos instalan `/usr/lib/libpoppler.so.146` y son artefactos DISTINTOS ⇒ una imagen
176  # que hidrate las dos pone dos ficheros en la misma ruta y gana el que se proyecte último, que es
177  # el cuadro de las dos glib. KDE ya trae `okular`, que arrastra la poppler de Qt6.
178  # Si alguna vez se quiere zathura en KDE, la salida NO es listarla acá: es jubilar una de las dos
179  # popplers. Escrito también en `recipes/poppler-glib.toml` y `recipes/zathura.toml`.
180  # El plugin va de raíz APARTE del visor a propósito: `zathura` no lo declara en `[deps]` de
181  # runtime —lo carga con dlopen— así que sin esta línea la imagen traería un visor que abre la
182  # ventana y dice «unknown file type». Sellado ≠ instalado, otra vez.
183  "zathura", "zathura-pdf-poppler",
184  # ── LAS `.so` QUE mesa Y wayland PIDEN EN RUNTIME Y NINGÚN ARTEFACTO DEL CIERRE PROVEE ────────
185  # Medido el 2026-09-03 recorriendo los NEEDED de todo el cierre de esta imagen contra los SONAME
186  # que ese mismo cierre publica: `libEGL.so.1` pide `libexpat.so.1` y `libwayland-client.so.0` pide
187  # `libffi.so.8`, y las recetas canónicas de expat y libffi son `--disable-shared`. O sea que el
188  # rootfs hidratado los resolvía contra el **sysroot Alpine DEL LAB**.
189  # Es peor que una dep faltante: el lab NO entra en `hash_inputs`, así que la fuga es invisible para
190  # el store — el artefacto se da por bueno y sólo arranca en una máquina con Alpine debajo.
191  # No es un descubrimiento nuevo: es EXACTAMENTE lo que el perfil `escritorio-sway` ya documentó
192  # para `sway`, sólo que ahí se encontró a mano al armar la imagen y estas tres nunca se revisaron.
193  # Van de raíces (y no de `[deps]`) por lo mismo que las fuentes y el XKB: son data de RUNTIME y
194  # nadie las declara como dep de BUILD, así que la clausura no puede alcanzarlas por ninguna arista.
195  # `bzip2-shared` se suma el 2026-09-03, cazada por `scripts/vigia-sonames.py` en los TRES perfiles
196  # a la vez: `freetype-shared` sale con `NEEDED libbz2.so.1` y el `bzip2` canónico del corpus es
197  # `.a`. Es la misma fuga al sysroot del lab que expat y libffi, y venía de antes que zathura —
198  # sólo que hasta ahora nadie cargaba freetype-shared en RUNTIME. Se vio de verdad al probar el
199  # visor: el plugin de PDF no hacía dlopen («Error relocating /usr/lib/libbz2.so.1»). La receta
200  # existía sólo en `incoming-kde`; promovida al corpus con el mismo hash (b3:1e404254 desde las dos
201  # partes ⇒ un solo artefacto, cero rebuilds).
202  # ── FUENTES ──────────────────────────────────────────────────────────────────────────────────
203  # ⚠ Añadida el 2026-09-03 porque este perfil no traía NI UN FICHERO DE FUENTE. Medido recorriendo
204  # los artefactos del cierre y contando `.ttf/.otf/.ttc/.pfb`: **gnome=0**, sway=22 (dejavu),
205  # kde=1 (una que viene dentro de qtbase). `fontconfig` estaba, pero fontconfig es el MOTOR que
206  # busca fuentes, no una fuente — tenerlo y creer que hay tipografía es el mismo error que
207  # confundir un directorio vacío con un artefacto.
208  # Se descubrió con `poppler-render-check`: un PDF con fuentes base-14 (Helvetica, Times…) NO
209  # trae la tipografía adentro, la sustituye el visor por fontconfig, así que sin fuentes el
210  # documento se ve VACÍO — y el visor no da error, que es lo peor.
211  # `dejavu-fonts` es la única receta de fuentes del catálogo entero. Que KDE esté igual (1 fuente
212  # de rebote, dentro de qtbase) es un hallazgo aparte y NO se toca acá: ese perfil no lleva zathura
213  # y su árbol lo está trabajando otro frente.
214  "dejavu-fonts",
215  # `dejavu-fonts-nerd` es la MISMA DejaVu Sans Mono parcheada con Nerd Fonts (~10.000 glifos de
216  # iconos: Powerline, Font Awesome, Devicons…) que usan starship, lsd, eza, neovim y las
217  # statuslines; sin ellos dibujan cuadraditos. Se AÑADE, no reemplaza: la licencia de Bitstream
218  # Vera obliga a renombrar una fuente modificada, así que la parcheada se llama
219  # «DejaVuSansM Nerd Font Mono» y NO puede responder a «DejaVu Sans Mono» — sustituirla rompería
220  # a todo lo que la pide por nombre, empezando por foot. Se enchufa por fontconfig: su
221  # `59-nerd-monospace.conf` hace que el alias `monospace` la prefiera. Ver su receta.
222  "dejavu-fonts-nerd",
223  "expat-shared", "libffi-shared", "bzip2-shared",
224]
225
226[perfil.escritorio-cosmic]
227descripcion = "escritorio COSMIC (System76, Rust sobre smithay/iced) desde fuente — 4º escritorio"
228cola = "incoming-cosmic"
229# Las raíces son EXACTAMENTE lo que `cosmic-session/src/main.rs` levanta, más el gestor mismo y los
230# datos que ningún `[deps]` alcanza. El resto es CLAUSURA.
231#
232# ── POR QUÉ ESTE PERFIL NO ES BUROCRACIA ────────────────────────────────────────────────────────
233# Sin él, `yupana radio` sobre cualquier receta COMPARTIDA —libinput, libxkbcommon, libudev-zero,
234# mesa, wayland— devuelve «IMÁGENES afectadas: (ninguna declarada)» para COSMIC, y el próximo que las
235# toque MIDE DE MENOS. La campaña existe en el store y en el runbook, pero el ábaco no la ve: el radio
236# de un re-hash es justo lo que el perfil convierte en dato.
237#
238# Nota de nombres, que acá no coinciden y ya costó una vez: el repo `cosmic-workspaces-epoch` produce
239# el binario `cosmic-workspaces`, y el AppID tampoco lleva el sufijo. Se lista por el nombre de la
240# RECETA, que es el del repo.
241paquetes = [
242  "cosmic-comp", "cosmic-session", "cosmic-settings-daemon",
243  "cosmic-panel", "cosmic-launcher", "cosmic-app-library", "cosmic-workspaces-epoch",
244  "cosmic-notifications", "cosmic-osd", "cosmic-bg", "cosmic-idle",
245  # Los applets del panel. No es un componente que la sesión lance: lo spawnea el PANEL, por AppID,
246  # y sin ellos arranca y no se dibuja. Un binario multiplexor con veinte symlinks.
247  "cosmic-applets",
248  # El MOTOR del lanzador, de otro repo y fuera del pin `epoch-N`: `cosmic-launcher` sólo dibuja y
249  # lanza a `pop-launcher` como proceso hijo por PATH. Sin él, `Super` no abre nada.
250  "pop-launcher",
251  # Y el `qalc` al que el plugin `calc` le pasa la expresión: tercer nivel de hijo por PATH. Es la
252  # primera raíz del perfil que existe para que una TECLA dé un resultado, no para que algo enlace.
253  "libqalculate",
254  # La primera APLICACIÓN con ventana del catálogo, y la primera entrada de la biblioteca que no es
255  # `NoDisplay`. Hasta acá el perfil listaba escritorio; desde acá lista también lo que se abre.
256  "cosmic-term",
257  # La segunda: el gestor de ficheros. Sin `gvfs` (no hay glib compartida) ⇒ navegación local sí,
258  # montajes remotos no.
259  "cosmic-files",
260  # La tercera: el panel de control. Habla con los daemons por zbus, así que NO arrastra
261  # NetworkManager/udisks/accountsservice — sólo libdrm y dav1d sobre el juego fijo.
262  "cosmic-settings",
263  # La cuarta: el editor de texto, y la más barata de las cuatro — su árbol ya estaba compilado (usa
264  # `cosmic-files` como crate, igual que la terminal). Su binario enlaza SÓLO `libxkbcommon` y
265  # `libc.so`: dos NEEDED, el mínimo de todos los clientes de la suite.
266  "cosmic-edit",
267  # La quinta: la tienda. Con el backend `pkgar` —el único de los cuatro que no pide ni una torre de
268  # C (flatpak) ni un demonio ausente (packagekit)— NAVEGA el catálogo instalado leyendo el AppStream
269  # del sistema, pero NO instala: nada está cableado al `.swm` de hammer.
270  "cosmic-store",
271  # La sexta: la captura de pantalla. Cero C —el único `[deps] build = []` de la campaña— pero HOY
272  # NO FUNCIONA: todo su trabajo es `Screenshot::request()` contra `org.freedesktop.portal.Desktop`,
273  # y en la imagen no hay portal. Se lista igual para que el hueco sea visible.
274  "cosmic-screenshot",
275  # La CADENA DEL PORTAL, dos raíces porque son dos procesos que se encuentran por D-Bus en runtime:
276  # el frontend registra `org.freedesktop.portal.Desktop` y enruta al backend, que implementa
277  # Access/FileChooser/Screenshot/Settings/ScreenCast. Sin ellos no hay captura, ni selector de
278  # ficheros de portal, ni compartir pantalla.
279  "xdg-desktop-portal", "xdg-desktop-portal-cosmic",
280  # Y la SONDA con que se mide esa cadena. No es escritorio: es el instrumento. Se lista como raíz
281  # porque nadie la declara como dep y sin ella el perfil no incluiría con qué verificarse a sí
282  # mismo — un handshake de portal sólo se puede ejercer DESDE la sesión, con bus y compositor vivos.
283  "portal-probe",
284  # El GESTOR DE SESIÓN de pipewire. Se lista como raíz porque ningún `[deps]` lo alcanza: es un
285  # CLIENTE del demonio, no una librería de nadie. Trae consigo la glib COMPARTIDA (`glib-shared`),
286  # que no es la estática que usa el resto de la cola — wireplumber produce `.so` y la estática del
287  # corpus no es PIC. Construido y corriendo; NO desbloqueó ScreenCast (ver el runbook).
288  "wireplumber",
289  # Datos, no binarios: el tema de iconos (y el hicolor del que hereda), las tablas de xkb y una
290  # tipografía. Ninguno es dep de build de nadie y sin ellos el escritorio arranca roto — sin puntero,
291  # sin teclado o con tofu.
292  "cosmic-icons", "hicolor-icon-theme", "xkeyboard-config", "dejavu-fonts",
293  # `dejavu-fonts-nerd` es la MISMA DejaVu Sans Mono parcheada con Nerd Fonts (~10.000 glifos de
294  # iconos: Powerline, Font Awesome, Devicons…) que usan starship, lsd, eza, neovim y las
295  # statuslines; sin ellos dibujan cuadraditos. Se AÑADE, no reemplaza: la licencia de Bitstream
296  # Vera obliga a renombrar una fuente modificada, así que la parcheada se llama
297  # «DejaVuSansM Nerd Font Mono» y NO puede responder a «DejaVu Sans Mono» — sustituirla rompería
298  # a todo lo que la pide por nombre, empezando por foot. Se enchufa por fontconfig: su
299  # `59-nerd-monospace.conf` hace que el alias `monospace` la prefiera. Ver su receta.
300  "dejavu-fonts-nerd",
301  # Lo que `start-cosmic` ejecuta y ningún `[deps]` pide: bash de verdad y el bus de sesión.
302  "bash", "dbus",
303  # ── LA PRIMERA APP DE USUARIO FINAL QUE COMPARTEN LOS CUATRO ESCRITORIOS ──────────────────────
304  # `mpv` vive en el CORPUS, no en esta cola, justamente para poder listarse en las cuatro: una
305  # receta resuelve sibling-first y después el catálogo padre, así que desde acá se alcanza.
306  # Va de raíz por la lección que este mismo fichero ya aprendió con `foot` en el perfil de sway:
307  # una receta sellada que ningún perfil declara NO ESTÁ EN NINGUNA IMAGEN, y la métrica de
308  # clausura no lo puede ver porque mide lo declarado. Sellado ≠ instalado.
309  # ⚠ Hoy entra con tres huecos escritos en `recipes/mpv.toml`: audio por ALSA con
310  # `-Dpipewire-alsa=disabled` en las pipewire (⇒ no suena con PipeWire vivo), sin Lua (⇒ sin OSC)
311  # y sin vaapi (⇒ sin decodificación por hardware).
312  "mpv",
313  # ── VISOR DE IMÁGENES, TAMBIÉN EN LAS CUATRO ─────────────────────────────────────────────────
314  # `swayimg` y no `imv`, que era lo que proponía `docs/plan-apps-usuario-final.md`: imv dibuja con
315  # OpenGL de función fija (`glBegin`/`glOrtho`) y esta distro NO tiene proveedor de GL de
316  # escritorio — las tres mesa van `-Dglx=disabled -Dglvnd=false` ⇒ no hay `libGL.so` ni `gl.pc` en
317  # ninguna cola. swayimg rasteriza a `wl_shm` y no toca GL; el porqué largo está en su receta.
318  # Trae de yapa backend DRM: muestra imágenes en una TTY pelada, sin compositor.
319  "swayimg",
320  # ── LECTOR DE DOCUMENTOS ─────────────────────────────────────────────────────────────────────
321  # ⚠ NO ESTÁ EN `escritorio-kde`, y no es un olvido. `zathura-pdf-poppler` necesita `poppler-glib`,
322  # que es una receta NUEVA del corpus (la que ya existía va `-DENABLE_GLIB=OFF` y vive en la cola
323  # de KDE). Las dos instalan `/usr/lib/libpoppler.so.146` y son artefactos DISTINTOS ⇒ una imagen
324  # que hidrate las dos pone dos ficheros en la misma ruta y gana el que se proyecte último, que es
325  # el cuadro de las dos glib. KDE ya trae `okular`, que arrastra la poppler de Qt6.
326  # Si alguna vez se quiere zathura en KDE, la salida NO es listarla acá: es jubilar una de las dos
327  # popplers. Escrito también en `recipes/poppler-glib.toml` y `recipes/zathura.toml`.
328  # El plugin va de raíz APARTE del visor a propósito: `zathura` no lo declara en `[deps]` de
329  # runtime —lo carga con dlopen— así que sin esta línea la imagen traería un visor que abre la
330  # ventana y dice «unknown file type». Sellado ≠ instalado, otra vez.
331  "zathura", "zathura-pdf-poppler",
332  # ── LAS `.so` QUE mesa Y wayland PIDEN EN RUNTIME Y NINGÚN ARTEFACTO DEL CIERRE PROVEE ────────
333  # Medido el 2026-09-03 recorriendo los NEEDED de todo el cierre de esta imagen contra los SONAME
334  # que ese mismo cierre publica: `libEGL.so.1` pide `libexpat.so.1` y `libwayland-client.so.0` pide
335  # `libffi.so.8`, y las recetas canónicas de expat y libffi son `--disable-shared`. O sea que el
336  # rootfs hidratado los resolvía contra el **sysroot Alpine DEL LAB**.
337  # Es peor que una dep faltante: el lab NO entra en `hash_inputs`, así que la fuga es invisible para
338  # el store — el artefacto se da por bueno y sólo arranca en una máquina con Alpine debajo.
339  # No es un descubrimiento nuevo: es EXACTAMENTE lo que el perfil `escritorio-sway` ya documentó
340  # para `sway`, sólo que ahí se encontró a mano al armar la imagen y estas tres nunca se revisaron.
341  # Van de raíces (y no de `[deps]`) por lo mismo que las fuentes y el XKB: son data de RUNTIME y
342  # nadie las declara como dep de BUILD, así que la clausura no puede alcanzarlas por ninguna arista.
343  # `bzip2-shared` se suma el 2026-09-03, cazada por `scripts/vigia-sonames.py` en los TRES perfiles
344  # a la vez: `freetype-shared` sale con `NEEDED libbz2.so.1` y el `bzip2` canónico del corpus es
345  # `.a`. Es la misma fuga al sysroot del lab que expat y libffi, y venía de antes que zathura —
346  # sólo que hasta ahora nadie cargaba freetype-shared en RUNTIME. Se vio de verdad al probar el
347  # visor: el plugin de PDF no hacía dlopen («Error relocating /usr/lib/libbz2.so.1»). La receta
348  # existía sólo en `incoming-kde`; promovida al corpus con el mismo hash (b3:1e404254 desde las dos
349  # partes ⇒ un solo artefacto, cero rebuilds).
350  "expat-shared", "libffi-shared", "bzip2-shared",
351]
352
353[perfil.escritorio-sway]
354descripcion = "WM Wayland ligero: sway sobre wlroots propio, sin X11 y sin systemd"
355cola = "incoming-wlr"
356hereda = ["cli"]
357# Sellado entero el 2026-08-07. A diferencia de los otros tres escritorios, éste NO tiene una torre
358# de C debajo: son una decena de binarios pequeños sobre wlroots, y por eso salió en una noche
359# mientras KDE y GNOME fueron campañas de semanas.
360#
361# `hereda = ["cli"]` a propósito: un WM ligero sin userland debajo no se usa: hace falta la terminal
362# y las herramientas.
363#
364# 2026-08-26: este comentario decía que `foot` «entra por la clausura de cli, así que no se lista
365# acá». ERA FALSO y el grafo lo desmentía: `foot` está sellado en el corpus pero `perfil.cli` no lo
366# lista entre sus raíces, así que ningún perfil lo arrastraba. El perfil daba 121/121 SIN EMULADOR DE
367# TERMINAL — sellado completo y aun así inusable. Se detectó al hidratar la clausura para armar la
368# imagen, no antes: la métrica de perfil mide la clausura de las raíces declaradas, y no puede ver lo
369# que falta en la declaración. `foot` se lista ahora donde le toca, entre las raíces del escritorio.
370#
371# Sólo RAÍCES: la clausura —wlroots, mesa, wayland, libinput, seatd, cairo, pango, fcft…— la calcula
372# el grafo siguiendo las aristas de deps. Escribirla a mano sería justo lo que targets.toml existe
373# para no hacer.
374paquetes = [
375  # el compositor y sus utilidades propias
376  "sway",
377  # lo que hace que se USE y no sólo arranque
378  "yambar",        # barra de estado (yambar y no waybar: waybar exige gtkmm-3.0, o sea GTK3 + sus
379                   # bindings C++, que es deuda aparcada por diseño. Medido, no supuesto.)
380  "foot",          # emulador de terminal (misma familia que fcft/tllist, ya en la clausura)
381  "fuzzel",        # lanzador de aplicaciones
382  # ── DATOS, no binarios: nadie los declara como dep de build, así que SÓLO entran como raíces ──
383  # Ninguna receta depende de una fuente ni de un mapa de teclado para COMPILAR, de modo que la
384  # clausura no puede alcanzarlos por más aristas que siga. Si no están acá, no están.
385  "dejavu-fonts",       # sin UNA fuente, foot muere con «monospace::size=8: failed to match font»
386  # `dejavu-fonts-nerd` es la MISMA DejaVu Sans Mono parcheada con Nerd Fonts (~10.000 glifos de
387  # iconos: Powerline, Font Awesome, Devicons…) que usan starship, lsd, eza, neovim y las
388  # statuslines; sin ellos dibujan cuadraditos. Se AÑADE, no reemplaza: la licencia de Bitstream
389  # Vera obliga a renombrar una fuente modificada, así que la parcheada se llama
390  # «DejaVuSansM Nerd Font Mono» y NO puede responder a «DejaVu Sans Mono» — sustituirla rompería
391  # a todo lo que la pide por nombre, empezando por foot. Se enchufa por fontconfig: su
392  # `59-nerd-monospace.conf` hace que el alias `monospace` la prefiera. Ver su receta.
393  "dejavu-fonts-nerd",
394  "xkeyboard-config",   # sin datos XKB: «xkbcommon: ERROR: failed to add default include path
395                        # /usr/share/X11/xkb», y sway no completa el seat
396  # ── LAS TRES `.so` QUE sway PIDE Y EL CORPUS SÓLO PRODUCE COMO `.a` ─────────────────────────
397  # `sway` es `link = "dynamic"` a propósito (dlopea los drivers DRI de mesa) y sale con
398  # `NEEDED libz.so.1 / libexpat.so.1 / libffi.so.8`. Las canónicas son `--disable-shared`, así que
399  # ningún artefacto sellado producía esos `.so` y el rootfs hidratado los resolvía contra el
400  # sysroot Alpine DEL LAB. Peor que una dep faltante: el lab NO entra en `hash_inputs`, así que la
401  # fuga era invisible para el store — el artefacto se daba por bueno y sólo arrancaba en una
402  # máquina con Alpine debajo. Los otros nueve NEEDED de sway (pixman, drm, evdev, input, udev,
403  # wayland-server, wlroots, xkbcommon, libc) sí los cubre la clausura, porque esas recetas ya son
404  # `link = dynamic`. Como las tres son data de runtime y nadie las declara como dep de BUILD, van
405  # de raíces por la misma razón que las fuentes y el XKB de arriba.
406  # `bzip2-shared` se suma el 2026-09-03, cazada por `scripts/vigia-sonames.py` en los TRES perfiles
407  # a la vez: `freetype-shared` sale con `NEEDED libbz2.so.1` y el `bzip2` canónico del corpus es
408  # `.a`. Es la misma fuga al sysroot del lab que expat y libffi, y venía de antes que zathura —
409  # sólo que hasta ahora nadie cargaba freetype-shared en RUNTIME. Se vio de verdad al probar el
410  # visor: el plugin de PDF no hacía dlopen («Error relocating /usr/lib/libbz2.so.1»). La receta
411  # existía sólo en `incoming-kde`; promovida al corpus con el mismo hash (b3:1e404254 desde las dos
412  # partes ⇒ un solo artefacto, cero rebuilds).
413  "zlib-shared", "expat-shared", "libffi-shared", "bzip2-shared",
414  "swaybg",        # fondo de escritorio
415  "swaylock",      # bloqueo de pantalla (con PAM: linux-pam SÍ está en el corpus)
416  "swayidle",      # apagado por inactividad
417  # el par de captura y el portapapeles, sin los cuales media docena de flujos no cierran
418  "grim", "slurp", "wl-clipboard",
419  # ── LA PRIMERA APP DE USUARIO FINAL QUE COMPARTEN LOS CUATRO ESCRITORIOS ──────────────────────
420  # `mpv` vive en el CORPUS, no en esta cola, justamente para poder listarse en las cuatro: una
421  # receta resuelve sibling-first y después el catálogo padre, así que desde acá se alcanza.
422  # Va de raíz por la lección que este mismo fichero ya aprendió con `foot` en el perfil de sway:
423  # una receta sellada que ningún perfil declara NO ESTÁ EN NINGUNA IMAGEN, y la métrica de
424  # clausura no lo puede ver porque mide lo declarado. Sellado ≠ instalado.
425  # ⚠ Hoy entra con tres huecos escritos en `recipes/mpv.toml`: audio por ALSA con
426  # `-Dpipewire-alsa=disabled` en las pipewire (⇒ no suena con PipeWire vivo), sin Lua (⇒ sin OSC)
427  # y sin vaapi (⇒ sin decodificación por hardware).
428  "mpv",
429  # ── VISOR DE IMÁGENES, TAMBIÉN EN LAS CUATRO ─────────────────────────────────────────────────
430  # `swayimg` y no `imv`, que era lo que proponía `docs/plan-apps-usuario-final.md`: imv dibuja con
431  # OpenGL de función fija (`glBegin`/`glOrtho`) y esta distro NO tiene proveedor de GL de
432  # escritorio — las tres mesa van `-Dglx=disabled -Dglvnd=false` ⇒ no hay `libGL.so` ni `gl.pc` en
433  # ninguna cola. swayimg rasteriza a `wl_shm` y no toca GL; el porqué largo está en su receta.
434  # Trae de yapa backend DRM: muestra imágenes en una TTY pelada, sin compositor.
435  "swayimg",
436  # ── LECTOR DE DOCUMENTOS ─────────────────────────────────────────────────────────────────────
437  # ⚠ NO ESTÁ EN `escritorio-kde`, y no es un olvido. `zathura-pdf-poppler` necesita `poppler-glib`,
438  # que es una receta NUEVA del corpus (la que ya existía va `-DENABLE_GLIB=OFF` y vive en la cola
439  # de KDE). Las dos instalan `/usr/lib/libpoppler.so.146` y son artefactos DISTINTOS ⇒ una imagen
440  # que hidrate las dos pone dos ficheros en la misma ruta y gana el que se proyecte último, que es
441  # el cuadro de las dos glib. KDE ya trae `okular`, que arrastra la poppler de Qt6.
442  # Si alguna vez se quiere zathura en KDE, la salida NO es listarla acá: es jubilar una de las dos
443  # popplers. Escrito también en `recipes/poppler-glib.toml` y `recipes/zathura.toml`.
444  # El plugin va de raíz APARTE del visor a propósito: `zathura` no lo declara en `[deps]` de
445  # runtime —lo carga con dlopen— así que sin esta línea la imagen traería un visor que abre la
446  # ventana y dice «unknown file type». Sellado ≠ instalado, otra vez.
447  "zathura", "zathura-pdf-poppler",
448  # ── GRABADOR DE PANTALLA — sólo acá, y la razón es de PROTOCOLO, no de gusto ──────────────────
449  # `wf-recorder` captura por `wlr-screencopy`, que implementan los compositores wlroots. KWin y
450  # mutter NO lo implementan (usan el portal/ScreenCast), así que ponerlo en esas dos imágenes
451  # sería enviar una herramienta que no puede funcionar ahí — deuda fantasma con forma de app.
452  # En COSMIC habría que VERIFICAR si cosmic-comp expone el protocolo antes de listarlo.
453  # Es la app que cobra la promoción de pipewire al corpus (2026-09-03): antes grababa muda.
454  "wf-recorder",
455]