1# Plan — apps de usuario final (montón A del ADR 0015), MEDIDO
2
3**Fecha de la medición:** 2026-09-03 · **Catálogo contra el que se midió:** 1079 recetas
4(corpus + las cuatro colas) · **Instrumento:** `makedepends`+`depends` del APKBUILD de Alpine de
5cada candidata, cruzados contra los nombres de receta que existen en el disco.
6
7## Por qué existe este documento
8
9El [ADR 0015](adr/0015-imagenes-ajenas.md) parte las apps que faltan en tres montones y dice del
10**A** —Firefox, Chromium, LibreOffice, mpv, GIMP, Inkscape, Blender, OBS— que no lo bloquea *«nada
11estructural: son Wayland-nativos y compilables. Falta escribirlas»*, y propone el orden
12**mpv → OBS → Firefox**.
13
14`mpv` se escribió el 2026-09-03 y esa parte se confirmó. Al ir por el segundo, la medición
15**desmiente la premisa para el resto del montón**: OBS y Firefox no están a una receta de distancia,
16están detrás de muros que esta distro levantó a propósito. Este documento deja el dato escrito para
17que la decisión se tome mirándolo y no de memoria.
18
19## Cómo leer la tabla
20
21Dos columnas, y **la que importa es la segunda**:
22
23- **recetas que faltan** — cuántos `makedepends` de Alpine no tienen receta acá. Es una **cota
24  superior floja**: Alpine construye con todo activado y nosotros no. El control lo da `mpv`, que
25  YA ESTÁ SELLADA y aun así aparece con 16 faltantes — son exactamente las perillas que su receta
26  apaga a propósito (jack, sndio, libbluray, zimg, rubberband…). O sea: un número alto no prueba
27  que sea caro.
28- **muros de diseño** — dependencias que NO son «una receta más», sino decisiones ya tomadas de
29  esta distro: GTK3 aparcado, X11 al tacho, Qt6 que vive sólo en `incoming-kde`, toolchain wasi
30  inexistente. **Un muro no se paga escribiendo una receta: se paga cambiando una decisión.**
31
32## La tabla
33
34| app | faltan | muros | veredicto |
35|---|---:|---|---|
36| ~~wf-recorder~~ | — | — | ✅ **SELLADA 2026-09-03** (b3:25caa359), con audio. Se destrabó al promover pipewire al corpus. Sólo en `escritorio-sway`: captura por `wlr-screencopy` y KWin/mutter no lo implementan. |
37| ~~imv~~ | 7 | **GL de escritorio** | ❌ **BLOQUEADA 2026-09-03** — el muro no lo veía este método; ver abajo. Reemplazada por `swayimg`, sellada el mismo día. |
38| ~~swayimg~~ | — | — | ✅ **SELLADA 2026-09-03** (b3:9bcd39c1, **5.5**), en las CUATRO imágenes. Visor sin GL: rasteriza a `wl_shm`. Trae backend DRM de yapa. |
39| ~~luajit~~ | — | — | ✅ **SELLADA 2026-09-03** (b3:115d4c1c). Escrita para destrabar swayimg 5.x; mpv también la prefiere. |
40| ~~zathura~~ | — | — | ✅ **SELLADA 2026-09-03** (b3:9c5eac92) + `zathura-pdf-poppler`. **Es GTK4, no GTK3**: upstream vació girara. En gnome/cosmic/sway; **NO en KDE**, por colisión de poppler. |
41| ~~mupdf~~ | 9 | X11 **y GL de escritorio** | ❌ **BLOQUEADA 2026-09-03.** La nota era falsa: `mupdf-gl` **sí** es un muro — su `platform/gl/` va sobre GLUT + OpenGL de escritorio, el mismo muro que imv. mupdf **no tiene visor Wayland**: sus dos UIs son `mupdf-x11` y `mupdf-gl`. El motor (`libmupdf`+`mutool`) no tiene muros, pero no hace falta: el PDF ya lo da poppler. |
42| ~~inkscape~~ | 14 | **GTK3** (en la release) | ❌ **BLOQUEADA 2026-09-03.** Era GTK3 encubierto, como se sospechaba: `INKSCAPE_1_4_4` pide `gtkmm-3.0>=3.24` **y** `gtk+-3.0>=3.24`. `master` **sí** migró a GTK4 (`gtk4>=4.14`, `gtkmm-4.0>=4.13.3`) pero está sin publicar; y de todos modos el catálogo **no tiene NI UN binding C++**: faltan sigc++, glibmm, cairomm, pangomm y gtkmm enteros. |
43| *mpv* | *16* | *X11* | *YA SELLADA — es el control del método, no una candidata.* |
44| **gimp** | 18 | **GTK3**, X11 | GIMP 2.10 es GTK2/3. Fuera de alcance mientras GTK3 esté aparcado. |
45| **obs-studio** | 20 | **Qt6**, X11 | ver abajo. |
46| **firefox** | 26 | **GTK3**, X11, **wasi** | ver abajo. |
47| **chromium** | 38 | **GTK3**, **Qt6**, X11 | peor que Firefox por todos lados. |
48| **libreoffice** | 59 | **GTK3**, **Qt6**, X11 | 59 recetas y tres muros. No es un ticket, es un año. |
49
50## ⚠ El defecto del método, encontrado al usarlo (y lo que destapó)
51
52La columna «recetas que faltan» pregunta **¿existe esta receta en el disco?** y esa es la pregunta
53equivocada. La correcta es **¿la alcanza el consumidor?** — porque una receta resuelve sus deps
54sibling-first (su propia cola) y después el catálogo PADRE, **nunca una cola hermana**.
55
56Se descubrió al ir a escribir `wf-recorder`, que la tabla daba en 0/0: su `makedepends` pide
57`pipewire-dev` y `pulseaudio-dev`, los dos existen… **en las tres colas de escritorio y en ninguna
58en el corpus**. Una app del corpus no los ve. wf-recorder construye igual (`-Dpulse=disabled
59-Dpipewire=disabled`, `have_audio=false`) pero graba **sin sonido**, y no tiene backend ALSA con el
60que caerse.
61
62### Lo que eso destapa, que es más grande que wf-recorder
63
64> **El corpus no tiene ningún cliente de audio salvo ALSA.** `libpipewire-0.3` y `libpulse` viven
65> sólo en `incoming-{kde,gnome,cosmic}`. Toda app multimedia que llegue al corpus va a chocar acá.
66
67Ya chocó dos veces en un día: `mpv` terminó con `--ao=alsa` en vez de su salida nativa de PipeWire
68(y por eso hubo que dar vuelta `-Dpipewire-alsa` en las tres pipewire, que fue el arreglo correcto
69pero fue un rodeo), y ahora `wf-recorder` se queda mudo.
70
71**DECIDIDA Y HECHA el 2026-09-03 — opción 1, con una salvedad medida.** Lo que sigue queda como
72registro de por qué. La decisión era: promover UNA pipewire al corpus. Construye
73—el corpus tiene su propia `glib`, `dbus` y `pcre2`— pero el problema no es construirla: es que una
74imagen que hidrate `corpus/pipewire` **y** la de su cola pondría dos `libpipewire-0.3.so` distintas
75en la misma ruta, que es la enfermedad de las dos glib. Las salidas posibles, para pensarlas
76despierto:
77
781. **Una sola pipewire, en el corpus, y las tres colas jubilan la suya.** Es lo más limpio y es lo
79   que ya se hizo con otras 13 copias que sellaban igual — pero éstas NO sellan igual (difieren en
80   glib/dbus/pcre2), así que hay que decidir cuál gana y volver a sellar wireplumber y los portales
81   de las tres colas.
822. **Aceptar ALSA como la única ABI de audio del corpus**, que es lo que hoy quedó funcionando de
83   hecho: `-Dpipewire-alsa=enabled` hace que un cliente ALSA desemboque en PipeWire. Barato y ya
84   está hecho; el precio es que las apps del corpus nunca usan la API nativa (sin control por-stream,
85   sin metadata de sesión) y que las que sólo hablan pulse/pipewire —wf-recorder— quedan afuera.
863. **Que las apps multimedia vivan en las colas**, una copia por escritorio. Es lo que la estructura
87   empuja hoy y es exactamente lo que no queremos para una app que sirve a las cuatro imágenes.
88
89### Cómo se resolvió
90
91Ganó la **opción 1**, y salió barata porque la variante de COSMIC ya resolvía su cierre entero
92contra el catálogo padre: `recipes/pipewire.toml` sella el MISMO hash que tenía en la cola. Con ella
93subieron `libsndfile` y `dbus-shared` (duplicados exactos). 9 copias de cola jubiladas, **5
94rebuilds**.
95
96Lo que hizo segura la promoción fue una medición, no un argumento: **ningún pipewire enlaza glib**
97—sus NEEDED son `libdbus-1.so.3`, `libpulse.so.0`, `libsndfile.so.1`— así que `libpipewire-0.3.so`
98se comparte entre las cuatro imágenes sin repetir el episodio de las dos glib.
99
100**Y la salvedad, que es la parte que valía la pena medir:** `pulseaudio` NO se promovió.
101`libpulse-mainloop-glib.so.0.0.6` mide **45.712 bytes** en la variante de GNOME (NEEDED
102`libglib-2.0.so.0`) y **2.455.600** en la del corpus, que se traga la glib ESTÁTICA. Esa dentro del
103proceso de gnome-shell —que ya carga la glib sombra dinámica— es el cuadro de colord. Las tres
104pulseaudio se quedan: son variantes deliberadas. Sin esa salvedad los rebuilds habrían sido 8,
105incluido `gnome-shell`.
106
107La regla general que sale de acá, y sirve para la próxima promoción:
108
109> **Enlazar contra una variante y correr contra otra es legítimo cuando lo que cruza es un SONAME**
110> (misma ABI). Lo que no se puede es **hidratar dos artefactos distintos en la misma ruta**. Por eso
111> pipewire se puede compartir y pulseaudio no.
112
113Consecuencias inmediatas: `mpv` pasó a `-Dpipewire=enabled` (con ALSA detrás, para imágenes sin
114demonio) y `wf-recorder` se escribió y selló el mismo día.
115
116## ⚠ EL TERCER DEFECTO DEL MÉTODO: la receta existe, es alcanzable, y aun así no sirve
117
118El defecto anterior era «¿existe la receta?» ≠ «¿la alcanza el consumidor?». Al ir a escribir `imv`
119apareció un **tercer eje**, y es el peor de los tres porque las dos preguntas anteriores dan que sí:
120
121> **La receta existe, el consumidor la alcanza, y la VARIANTE que se construyó no publica la ABI
122> que hace falta.**
123
124`imv` pide OpenGL. `mesa` existe, está en el corpus, y cualquier receta lo alcanza. Pero:
125
126- `imv/src/canvas.c` hace `#include <GL/gl.h>` y dibuja con `glBegin` / `glOrtho` /
127  `GL_TRIANGLE_FAN` / `GL_TEXTURE_RECTANGLE`, o sea **OpenGL de función fija**, perfil de
128  compatibilidad. No existe equivalente en GLES: no es una perilla, es otra API.
129- Su `meson.build` hace `gl_dep = dependency('gl', required: false)` y, si no la encuentra,
130  `dependency('opengl')` **sin `required: false`** ⇒ el configure muere.
131- Y esta distro **no tiene ningún proveedor de OpenGL de escritorio**. Medido en los artefactos
132  sellados, no supuesto: las **tres** variantes de mesa (`mesa`, `mesa-swrast`, `mesa-llvmpipe`)
133  llevan `-Dglx=disabled -Dglvnd=false`, y sus artefactos publican `libEGL.so.1`, `libGLESv2.so.2`,
134  `libgbm` y `egl.pc`/`glesv2.pc`/`gbm.pc` — **ni un `libGL.so*`, ni `gl.pc`, ni `opengl.pc`**.
135  No hay receta `libglvnd` en ninguna cola.
136
137**La trampa fina, y es la parte que hay que recordar:** mesa SÍ instala `/usr/include/GL/gl.h`
138(el header viene con `-Dopengl=true`). O sea que una app así **compila entera** y muere recién al
139LIGAR. Un triaje que mire headers da verde.
140
141### Qué costaría darlo vuelta (para que la decisión se tome con el número)
142
143El camino que el propio `meson.build` de imv nombra —«libglvnd fallback for pure-wayland systems»—
144es autorar `libglvnd` (que provee `libOpenGL.so`/`opengl.pc`) y reconstruir mesa con `-Dglvnd=true`.
145Eso es **radio 139 dependientes directos** sobre `mesa`, y además convierte a libglvnd en pieza
146obligatoria de las cuatro imágenes: sin ella no hay EGL. Es una decisión de distro, no un ticket de
147visor de imágenes.
148
149### La salida, que resultó mejor que el original
150
151`swayimg` cubre el mismo caso de uso **sin tocar GL**: rasteriza a un buffer y lo entrega por
152`wl_shm`. Sus deps requeridas (xkbcommon, fontconfig, freetype2, wayland, wayland-protocols) ya
153estaban todas en el corpus ⇒ **cero recetas nuevas**. Y trae un backend **DRM** que muestra imágenes
154en una TTY pelada, sin compositor, que es exactamente lo que le falta al instalador.
155
156Entró primero como **4.7** —la última sin Lua— porque desde la 5.0 `dependency('luajit')` es
157obligatoria y no había receta (la `lua5.2` del OSC de mpv es otra ABI). Se escribió `luajit` el mismo
158día y subió a **5.5**. La cadena quedó verificada de punta a punta: `swayimg -e` reporta
159`Lua 5.1 · jit=true · LuaJIT 2.1.1787165859`, que es exactamente el `relver` de nuestra receta.
160`luajit` queda además disponible para mpv, que la prefiere sobre 5.2.
161
162**Regla que sale de acá, para el próximo triaje de apps:** la pregunta no es «¿existe la receta?»
163ni sólo «¿la alcanza?», sino **«¿la variante sellada publica el `.pc` y el `.so` que el consumidor
164pide?»**. Se contesta mirando el artefacto, no el catálogo.
165
166Y como acá cada punto ciego se convierte en un guardián, esa pregunta ya tiene instrumento:
167**`scripts/provee.py`**, que indexa los `.pc` y las librerías de TODOS los artefactos sellados y
168contesta quién publica cada nombre y desde qué colas se alcanza. Los tres defectos del método caen
169con un solo comando:
170
171```sh
172scripts/provee.py --desde corpus gl opengl     # ✗ nadie lo publica  → exit 1  (el caso imv)
173scripts/provee.py exiv2 librsvg                # ✓ existen, alcanzables SÓLO desde su cola
174```
175
176Es el hermano de build de `vigia-sonames.py`, que cubre la mitad de runtime. **El triaje de la
177próxima app empieza por acá**, no por contar `makedepends` contra `recipes/*.toml`.
178
179## El montón A quedó AGOTADO de cosas sin muro (2026-09-03)
180
181Con `zathura` cerrada, se re-triaron con `scripts/provee.py` las tres candidatas que la tabla daba
182como baratas o dudosas. **Las tres son muro**, y ninguna lo era por el motivo que decía la tabla:
183
184- **imv** → no hay proveedor de OpenGL de escritorio (sección de arriba). Sustituida por `swayimg`.
185- **mupdf** → sus DOS visores son X11 o GLUT+OpenGL de escritorio. No tiene UI Wayland.
186- **inkscape** → la release es GTK3; el `master` con GTK4 está sin publicar y además pide toda la
187  torre de bindings C++ que este catálogo no tiene (`provee.py` da ✗ en sigc++-2.0, glibmm-2.4,
188  cairomm-1.0, pangomm-1.4, gtkmm-3.0 **y** gtkmm-4.0).
189
190**Todo lo que queda del montón A está detrás de UNA de cuatro decisiones**, no de trabajo de
191recetas: GTK3 (inkscape-release, gimp, firefox), Qt6-en-el-corpus (obs), OpenGL de escritorio
192(imv, mupdf-gl) o X11 (chromium, mupdf-x11). Ver «los dos veredictos» abajo y el orden propuesto.
193
194## ⚠ Lo que SÍ estaba roto y no era falta de recetas: imágenes sin terminal
195
196Al terminar zathura se cruzó la membresía de los cuatro perfiles contra una lista de emuladores de
197terminal, editores y gestores de ficheros. El resultado no tiene nada que ver con el montón A y es
198más grave que cualquier app que falte:
199
200| perfil | terminal | editor | archivos |
201|---|---|---|---|
202| `escritorio-cosmic` | cosmic-term | cosmic-edit | cosmic-files |
203| `escritorio-sway` | foot | vim | — |
204| `escritorio-gnome` | **—** | **—** | — |
205| `escritorio-kde` | **—** | **—** | — |
206
207Es la lección de `foot` otra vez y a mayor escala: sway llegó a 121/121 **sin emulador de terminal**
208porque nadie lo declaraba, y la métrica de clausura no lo puede ver porque mide lo DECLARADO.
209
210**GNOME arreglado el 2026-09-03 con CERO recetas nuevas**: `foot` y `helix` viven en el corpus, ya
211estaban selladas y **no las declaraba ningún perfil**. foot es Wayland puro sobre `xdg-shell` (no
212pide protocolos de wlroots) así que corre bajo mutter; su único NEEDED es `libc.so`.
213
214**KDE es un hallazgo aparte y NO se tocó**: tiene **22 apps con `.desktop` selladas en su cola y sin
215declarar** —konsole, dolphin, kate, okular, spectacle, ark, gwenview, systemsettings, kcalc…— y
216además le faltan `plasma-desktop`, `plasma-nm`, `plasma-pa`, `powerdevil` y `kscreen`, o sea red,
217audio, energía y pantalla. Su perfil son **13 raíces de ARRANQUE EN METAL**, no la imagen de
218escritorio completa (ésa se hidrató aparte, por hash). Reordenarlo es decisión del frente KDE.
219
220## Los dos veredictos que corrigen al ADR
221
222### Firefox NO es montón A
223
224Su APKBUILD pide `gtk+3.0-dev` — **Firefox no tiene backend GTK4 ni lo va a tener a corto plazo**, y
225GTK3 es una de las tres deudas que el frente GNOME aparcó por diseño.
226
227⚠ **CORREGIDO 2026-09-03: el X11 de Firefox NO es un muro.** Se listaba como tal por los `libxt` y
228`libxcomposite` del APKBUILD, pero en el árbol de Gecko todo el código X11 está detrás de
229`CONFIG["MOZ_X11"]` (`widget/gtk/moz.build:131`): es una PERILLA de build, no una dependencia
230estructural, y hay builds Wayland-only. El muro real de Firefox es **GTK3**, más un
231**toolchain wasi** (`wasi-sdk`, `wasi-compiler-rt`) que no existe en el
232corpus, más `nodejs`, `icu`, `nss/nspr`, `clang/llvm/lld` versionados y `cbindgen`.
233
234La memoria del repo decía que a Firefox «le falta subir el techo MSRV». Eso es cierto **y es lo
235menor**: el bloqueo real es GTK3.
236
237**Consecuencia estratégica, que es la decisión que hay que tomar despierto:** todos los navegadores
238del mundo Linux son o GTK3 (Firefox y derivados) o Chromium (que además arrastra Qt6 y GTK3 en
239Alpine). Entonces **«tener navegador» no es un ticket del montón A**: es elegir entre
240
2411. **autorar el stack GTK3** —revierte una decisión de diseño y reabre GIMP/Inkscape de paso—, o
2422. **darle el navegador a [qorpa](adr/0015-imagenes-ajenas.md)**, o sea tratarlo como montón B: el
243   navegador corre en la imagen ajena, hablando Wayland por socket.
244
245La opción 2 es coherente con todo lo demás que ya se decidió, y tiene una ventaja que conviene
246nombrar: el navegador es *justamente* el proceso al que menos ganas dan de darle el sistema entero.
247
248### OBS no puede ser una app del corpus
249
250Pide `qt6-qtbase-dev`, `qt6-qtbase-private-dev` y `qt6-qtsvg-dev`, y **Qt6 vive sólo en
251`incoming-kde/`**. Una receta resuelve sibling-first y después el catálogo padre: desde el corpus no
252se alcanza una cola. O sea que OBS hoy sólo puede existir **dentro de la cola de KDE**, y entonces
253no es una app de las cuatro imágenes sino una app de KDE. Súmese X11 (`libx11`, `libxcb`,
254`libxcomposite`, `libxinerama`) y 20 recetas nuevas (`libdatachannel`, `librist`, `libsrt`,
255`mbedtls`, `rnnoise`, `x264`, `luajit`, `swig`, `vlc`…).
256
257**Si lo que se quiere es grabar la pantalla** —que es el 80% de para qué se instala OBS— eso ya está
258al alcance de la mano: **`wf-recorder` sale con CERO recetas faltantes y cero muros**, porque su
259cierre (wayland, ffmpeg, libdrm) quedó completo cuando entró mpv.
260
261## Orden propuesto, en reemplazo del del ADR
262
2631. ✅ **mpv** — hecho (2026-09-03).
2642. **decisión de audio del corpus** (el ⚠ de arriba). Destraba wf-recorder y le da a mpv
265   su salida nativa. Es una decisión, no una campaña.
2663. **wf-recorder** — inmediato una vez tomada esa decisión; cubre el caso de uso principal de OBS.
2674. ✅ **visor de imágenes** — hecho (2026-09-03), pero con **`swayimg` 4.7 y no `imv`**: imv está
268   bloqueada por el muro de GL de escritorio (sección de arriba). En las cuatro imágenes.
2694b. ✅ **`luajit`** — hecha (2026-09-03). Destrabó swayimg 5.5 y queda disponible para mpv.
2705. ✅ **zathura + backend PDF** — hecho (2026-09-03). **La sospecha de GTK3 era falsa**: upstream
271   VACIÓ `girara` (en 2026.07.18 son siete `.c` de utilidades, cero GTK) y toda la UI se mudó a
272   zathura, que pide GTK4 >= 4.12 — que está en el corpus. Costó 5 recetas nuevas
273   (`girara`, `xxhash`, `poppler-glib`, `zathura`, `zathura-pdf-poppler`) + 4 promociones gratis al
274   corpus (`json-glib`, `lcms2`, `glib-shared`, `pcre2-shared`, `bzip2-shared`).
275   **No va en `escritorio-kde`**: su backend necesita una poppler con `ENABLE_GLIB=ON` y esa imagen
276   ya trae la de Qt6 vía okular; las dos instalan `/usr/lib/libpoppler.so.146`.
2776. ✅ **terminal y editor en GNOME** — hecho (2026-09-03), cero recetas: `foot` + `helix` del
278   corpus, que ya estaban selladas y sin declarar. Ver la sección de arriba.
2797. **DECISIÓN pendiente, y ahora bloquea a TODO lo que queda** — no es trabajo de recetas:
280   **(a)** autorar el stack GTK3 (destraba inkscape-release, GIMP y Firefox de una vez),
281   **(b)** dárselo a [qorpa](adr/0015-imagenes-ajenas.md) como montón B, o
282   **(c)** autorar la torre de bindings C++ (sigc++/glibmm/cairomm/pangomm/gtkmm-4) y seguir el
283   `master` sin publicar de Inkscape.
284   Hasta que se tome, el montón A no tiene ningún ticket barato: está agotado.
2858. **Aparte y sin decisión: las 22 apps de KDE selladas y sin declarar** (sección de arriba). No
286   cuesta un build — cuesta acordarlo con el frente KDE.
287
288OBS, Firefox, Chromium, GIMP y LibreOffice **salen del montón A** hasta que se decida GTK3 o qorpa.
289Que se llame montón A y no se pueda construir es peor que no tenerlo en la lista: es deuda fantasma,
290la misma figura que la terna de GNOME que había que sacar de `targets.toml` para que el grafo dejara
291de mentir.
292
293## Reproducir la medición
294
295⚠ **Ya no se reproduce así.** Lo que sigue describe el método ORIGINAL, que es el que falló las
296tres veces documentadas arriba; se deja escrito para que se entienda de dónde salieron los números
297de la tabla. El triaje de una app nueva se hace hoy cruzando sus `makedepends` contra
298`scripts/provee.py --desde corpus`, que pregunta por el artefacto y no por el catálogo.
299
300`/tmp/.../triaje-apps.py` fue un script de una sola vez; si hace falta repetirlo, lo que hace es:
301bajar el APKBUILD de cada candidata, extraer `makedepends`/`depends`, quitarles el sufijo `-dev`, y
302cruzar contra `recipes/*.toml` + `recipes/incoming-*/*.toml`, separando una lista fija de nombres
303que son muros de diseño (gtk+3.0, qt6-*, lib X11, wasi-*). No se guarda en `scripts/` porque la
304lista de candidatas es del momento, no un invariante que valga la pena vigilar.