gioser

sergio/takana

> Una distribución Linux construida con un laboratorio funcional y hermético en el > sótano, y una terminal mutable, clásica y anárquica en el piso de arriba — diseñada > desde el suelo para que una IA programadora entienda, modifique y co…

TOML 1373Shell 116Rust 74Markdown 641915 Definitions

⎇ b00d513fbb33ef3190d94c5ff9ecb1dc13cb9c41 docs/20-catalogo-publicable-y-completa.md Markdown · 382 lines · 23.4 KB History raw

qorpa D8: sniper sellado al store, con la marca que evita que la cifra mienta fdce080d9 · Sergio ·

1# SDD 20 — El catálogo de lo que falta: hasta PUBLICABLE y hasta COMPLETA
2
3Escrito 2026-08-07, a pedido del usuario: «el catálogo de todo lo que falta hasta decir *la distro
4está publicable*, y lo de más hasta *la distro está completa*».
5
6Este documento es el **inventario**. El [SDD 21](21-manual-del-piloto.md) es el **manual de a pie**:
7qué tiene que hacer el usuario, en qué orden, en cada una de las tres etapas.
8
9Todo lo de acá está **medido contra el repo el 2026-08-07**, no estimado de memoria. Donde hay un
10número, hay un comando que lo produjo.
11
12---
13
14## Los dos codos, y por qué están donde están
15
16- **PUBLICABLE** = un extraño puede descargarla, instalarla, usarla y actualizarla, y nosotros
17  estamos en regla al dársela. **No** significa que tenga todo lo que uno querría.
18- **COMPLETA** = tiene lo que una persona espera de un sistema de escritorio para su día a día, sin
19  tener que salir a buscar nada fuera.
20
21La distancia entre los dos codos es enorme y **el orden importa**: casi todo lo caro (navegador,
22ofimática) está DESPUÉS del primer codo, y casi todo lo bloqueante (legal, claves, actualización)
23está ANTES. La trampa clásica es invertirlos — pasarse meses con el navegador y descubrir el día del
24anuncio que no se puede publicar.
25
26---
27
28# PARTE I — Hasta «la distro está PUBLICABLE»
29
30## I.1 Estado de construcción: esto ya está casi cerrado
31
32Medido con `docs/state/build-state*.json` (el grafo, no recuento a mano):
33
34| frente | nodos | sellados | en deuda |
35|---|---:|---:|---:|
36| corpus | 771 | 759 | **12** |
37| KDE | 968 | 952 | 12 |
38| GNOME | 853 | 840 | 13 |
39| COSMIC | 818 | 806 | 12 |
40
41Los perfiles `base` (51 nodos) y `cli` (74 nodos) están **al 100%, deuda 0**.
42
43> ⚠️ **CORREGIDO 2026-08-08.** Este párrafo decía «KDE cierra 162/162». **Falso**: regenerado el
44> grafo, `escritorio-kde` está en **76/162**, y lo está en todos los commits recientes — o sea que ya
45> lo estaba cuando se escribió esta frase. El error fue leer `docs/state/build-state-kde.json` **sin
46> regenerarlo**: es un fichero GENERADO, y un generado que no se regenera es una foto vieja con
47> aspecto de dato fresco. En total hay **198 recetas de las colas de escritorio** (KDE 133, GNOME 37,
48> COSMIC 24) sin artefacto en su hash vigente.
49>
50> Se verificó que **NO lo causó la campaña del split** (SDD 23): se revirtieron una por una todas las
51> recetas tocadas —las 3 bibliotecas base, las 30 hojas, `dbus`, las 38 de la 2ª tanda— y el número
52> **no se movió de 198** en ningún caso.
53
54**La deuda real es una sola lista de 12 recetas, compartida por todos los frentes** (por eso el
55número se repite: es el mismo agujero visto desde cuatro grafos):
56
57```
58gtk4  libadwaita  gtksourceview  gtk4-hello  adwaita-hello  sourceview-hello
59hammer-edit  mirada-compositor  mirada-greeter  dwarves  llimphi-counter  wlr-randr
60```
61
62> ### ⚠️ CORREGIDO EL MISMO DÍA, MIDIENDO CONTRA EL WORKER
63> La primera versión de esta sección decía que las 12 «fallan en el worker por su rootfs: `python
64> OSError` en meson, `find_package` en cmake» y que el arreglo era declarar las herramientas en
65> `[deps]`. **Se probó y es falso.** cmake y meson corren perfectamente en el worker. Las causas son
66> **cuatro, distintas**, y ninguna es el rootfs. Se descubrió al construirlas de verdad en vez de
67> heredar el diagnóstico.
68
69**(a) Seis están bloqueadas por el muro del PIC — y el frente GNOME ya lo venció por otro camino.**
70`gtk4` del corpus es `link = "static"` y enlaza `libfontconfig.a`, que tiene **1122 reubicaciones
71no-PIC**: el enlace produce **13 032 errores** `relocation R_X86_64_64 cannot be used against local
72symbol`. No es una receta rota, es una imposibilidad estructural. Mientras tanto
73`recipes/incoming-gnome/gtk4.toml` —`link = "dynamic"` con las deps `-shared`— **está sellada**, y
74con ella `libadwaita` y `fontconfig-shared`.
75⇒ La cadena del corpus (`gtk4`, `libadwaita`, `gtksourceview`, `gtk4-hello`, `adwaita-hello`,
76`sourceview-hello`, `hammer-edit`) es un **duplicado superado** de la cadena dinámica de GNOME.
77Cerrarla no es «construirla»: es decidir si se **promueven las sombras `-shared` al corpus**, porque
78la resolución de deps es hermano→padre y una receta del corpus no ve a las de `incoming-gnome`.
79**Es una decisión de arquitectura, no una tarea** — y hay un aviso registrado de que promover a
80ciegas hace que variantes homónimas pisen recetas canónicas.
81
82**(b) `wlr-randr` — ✅ CERRADA HOY.** Le faltaban dos deps: `python3` (porque **meson es un script de
83Python**; sin intérprete la fase muere con exit 127, que se lee como «meson no está») y `libffi`
84(que la receta no usa: lo exige `wayland-client.pc` en su `Requires`). Auditadas las 1141 recetas,
85era **la única** con meson y sin python3.
86
87**(c) `dwarves` — frente propio, no deuda.** Falla porque nuestro `elfutils` entrega **sólo libelf**,
88deliberadamente: libdw arrastra argp/obstack/fts, «lo verdaderamente difícil en musl». Y no se
89arregla ampliando `elfutils`, porque de él cuelga **el kernel que ya reproduce bit a bit**; el camino
90correcto es una receta aparte `elfutils-libdw`. Sin urgencia: ningún perfil lo pide y el kernel
91desactiva `DEBUG_INFO_BTF` explícitamente por su ausencia. Se desbloquea cuando se quiera sched-ext.
92
93**(d) `mirada-compositor`, `mirada-greeter`, `llimphi-counter` — HUB-ONLY estructural.** Su `source`
94es `gitea@git.tawasuyu.net:...` por SSH y **el worker es sin secretos por diseño**. No es un fallo.
95`llimphi-counter` ni siquiera llega a construir: su `commit` es literalmente ceros, con el comentario
96«fijar al commit real» — es una receta sin terminar, y es de tawasuyu.
97
98### Y el hallazgo de fondo: nadie las estaba intentando
99El bucle del worker recorre `QUEUES="recipes/incoming recipes/incoming-go recipes/incoming-clib
100recipes/incoming-gnome-onda1 recipes/incoming-gnome-onda2 recipes/incoming-gnome recipes/incoming-kde"`
101— **el corpus (`recipes/`) no está en la lista**. Las 12 nunca se habían intentado en el worker. Buena
102parte de «la deuda» era de encolado, no técnica.
103
104## I.2 🚨 Lo legal — bloqueante
105
106### Licencias: de 0 a 1063 de 1141 en un día
107El 2026-08-07 se midió: **0 de 1141 recetas** declaraban licencia. (El informe previo decía «5 de
108771»; los dos números estaban mal — los «5» eran falsos positivos de `grep license`: el paquete
109`addlicense`, el paquete `cargo-bundle-licenses`, una línea de `install` y un comentario.)
110
111Ese mismo día se hizo lo estructural:
112- Campo `license` en la receta, **fuera de `hash_inputs`** ⇒ se puebla sobre recetas ya selladas sin
113  mover un solo `ArtifactHash`. Verificado en 40 recetas: 40 hashes idénticos, 0 cambiados.
114- `scripts/licencias.sh` mide de verdad (cuenta el campo, no la palabra) y siembra desde una tabla
115  curada.
116- Tabla curada por familias (toolchain, base C, gráficas, GNOME/GTK, Qt, KDE, X.Org, GnuPG,
117  freedesktop, kernel.org, PyPI) + el código propio de tawasuyu, que el usuario puso en **MIT**.
118
119**Estado al cierre del día: 1063 de 1141 (93%).** Cuatro escalones de evidencia, de peor a mejor:
120nombre (prohibido) → URL de fuente (familias) → API de licencias de GitHub → `Cargo.toml` del autor
121al tag exacto. Faltan 78. **Falta también** desambiguar ~55 SPDX obsoletos (`GPL-3.0` no dice si es
122`-only` u `-or-later`), que es trabajo humano: hay que leer cabeceras de fuentes.
123
124El cierre definitivo, para que la deuda no vuelva a abrirse con cada receta nueva, es capturar la
125licencia en la **fase de fetch**, que ya descarga y extrae cada tarball: ahí el dato pasa gratis.
126
127⚠️ **La regla que no se rompe**: no se rellena a ojo. Declarar mal una licencia es peor que dejarla
128vacía — convierte un hueco visible en una afirmación falsa. Concretamente se descartó el atajo
129«`k*` = KDE ⇒ LGPL»: en este catálogo `kail`, `kind`, `ko`, `kopia`, `krew`, `kustomize`, `kyverno`
130y toda la familia `kube*` son herramientas Go sin relación con KDE.
131
132### El texto de la licencia dentro del paquete — ✅ HECHO (y no donde yo dije)
133> **CORRECCIÓN.** Esto decía «va en `hammer pack`». El razonamiento del coste era correcto —las
134> fases SÍ entran al hash, así que hacerlo en la receta re-hashearía las 1141— pero **el sitio
135> estaba mal**: `pack` produce un `.swm`, una receta de transformación sobre fuente pública que por
136> diseño «NUNCA transporta binarios cocidos», e `install` REPRODUCE construyendo. **El canal de
137> paquetes de hammer no distribuye binarios.** Donde sí se entrega un binario es en la **imagen
138> instalable**, y ahí se hace ahora: `scripts/licencias-rootfs.sh` escribe
139> `/usr/share/licenses/<pkg>/` con el texto canónico de cada licencia de la expresión, más un
140> `MANIFEST.tsv` (1,0 MB para el perfil `cli`). Los 44 textos SPDX viven en `licenses/`.
141>
142> **Y VETA**: sale ≠0 si un paquete del rootfs no declara licencia. Al estrenarlo reveló que `base`
143> y `cli` llevaban 10 y 12 paquetes con binarios y licencia desconocida; hoy van 2 cada uno (`lsof`
144> y `tzdata`, que necesitan la vía `LicenseRef-` y siguen vetando a propósito).
145
146### Espejo de fuentes — la obligación que más se malentiende
147La GPL no pide «que el código exista en internet»: pide que **quien recibe el binario pueda obtener
148de nosotros la fuente correspondiente**. Hoy las recetas apuntan a URLs de terceros que se caen.
149
150Acá estamos inusualmente bien parados: cada receta pinea `tarball` + `sha256`, así que el espejo es
151mecánico **y encima verificable**. Pero tiene que existir **antes de la primera descarga**.
152
153### Imágenes ajenas (qorpa): fuera del catálogo, y por escrito
154Desde el [ADR 0015](adr/0015-imagenes-ajenas.md) hay una segunda cadena de suministro: rootfs de
155otras distros que corren enjaulados. **No entran en el catálogo publicable ni en el reporte de
156licencias, y la razón no es pereza: no podemos enumerarlas.** Un `dnf install` o un `pacman -S`
157dentro de una instancia trae paquetes que nadie declaró acá, y afirmar una licencia sobre eso sería
158inventarla.
159
160Lo que sí se hace, y alcanza:
161- **Se cuentan aparte, en clase `ajeno`** (`docs/state/qorpa-ajenos.toml` → `build-state.json` →
162  «187/188 listo … + 1 ajenas»). El riesgo real de todo el ADR es que en seis meses alguien las
163  cuente como corpus; en otra clase no se pueden contar mal.
164- **La licencia la pone quien las publica**, que no somos nosotros: el usuario trae la imagen por
165  URL + sha256 y la relación es con esa distro.
166- **Si algún día se espejan** —el mecanismo lo permite gratis, porque son cuerpo inmutable
167  direccionado por contenido (ADR 0014)— ahí sí hay que mirar licencia **y marca** antes, igual que
168  con Firefox: redistribuir un rootfs de Ubuntu sin modificar suele estar permitido, pero la
169  política de marca es cosa aparte y **no es una pregunta técnica**.
170
171**Novedad 2026-09-04, y no rompe nada de lo anterior: una de ellas YA está sellada al store.** El
172runtime *sniper* de Valve entra por `recipes/steam-runtime-sniper.toml` porque **no muta** —nadie le
173instala nada adentro—, así que el mismo tarball pineado da siempre el mismo árbol. Sigue **fuera**
174del catálogo publicable y del reporte de licencias: su receta lleva `foreign = true`, el grafo la
175clasifica `ajeno` y su `license` es un `LicenseRef-…-no-enumerable` explícito, que dice lo que hay
176—cientos de paquetes Debian que no podemos enumerar— en vez de dejar el campo vacío, que se leería
177como «todavía no la poblamos». Y la distinción del punto anterior sigue en pie con más filo:
178**replicarla a nuestras propias máquinas** con `hammer mirror push` es lo mismo que ya hace el ADR
1790013 con las fuentes; **publicarla a terceros** sigue pidiendo mirar licencia y marca antes, y eso
180no es una pregunta técnica.
181
182⚠️ Y el corolario que hay que escribir donde se lea: **el claim «hammer reproduce bit a bit» hay que
183acotarlo** desde el día que exista una instancia — *el sistema base reproduce; las instancias ajenas
184no, y se declaran como tales*. Sin eso, la cultura de números honestos se erosiona sola.
185
186### Marcas
187Redistribuir Firefox con su nombre y logo exige cumplir la política de marca de Mozilla (por eso
188Debian tuvo Iceweasel). Decidir por adelantado: cumplir o rebrandear. **No bloquea el primer
189lanzamiento** si se sale sin navegador propio.
190
191### La licencia de hammer — ✅ ya está
192`LICENSE` en la raíz y `license = "MIT"` en `Cargo.toml`. *(El SDD 19 decía que faltaba; era falso.)*
193
194## I.3 Infraestructura pública
195
1961. **Espejo de paquetes e imágenes.** Dimensionado real: el store son 128 G, pero **~60% es información de depuración** ⇒ separando `-debug` en paquetes aparte el espejo baja a **~51 G** (medido en la etapa 3 del SDD 23; el «79%» que se citaba era sobre el CONTENIDO BINARIO, no sobre el tamaño de artefacto).
1972. **Cadena de firma de release.** Hoy hay firma de índice. Falta el nivel de arriba: **clave raíz
198   fuera de línea**, claves de firma rotables y un procedimiento escrito para cuando se filtre una.
199   Firma sin gestión de claves es teatro.
2003. **Evidencia de reproducibilidad publicada.** Es *el* diferenciador: publicar junto a cada imagen
201   los `ArtifactHash` de toda su clausura, para que un tercero reconstruya y compare. Es lo que
202   convierte «somos reproducibles» en un hecho comprobable por un extraño.
2034. **Respuesta a seguridad**: un canal para reportes y —lo importante— la capacidad **demostrada** de
204   empujar una actualización y que llegue. Ensayar el ciclo completo con un CVE de mentira.
205
206## I.4 Que se pueda instalar y usar
207
2081. **Imagen instalable validada en METAL**, no sólo en QEMU. Está a medio camino: el USB de KDE en
209   metal está **en curso** y falta re-quemarlo. Reglas ya pagadas caro: validar imágenes de
210   escritorio **con pantalla**, nunca sólo `-nographic`; `/dev/console` es el serial, así que cada
211   capa debe escribir a `/dev/tty0`; y **nunca quemar a un NVMe**.
2122. **Matriz de hardware honesta**: en qué se probó y en qué no. Vale más «probado en estas 3
213   máquinas» que «debería funcionar».
2143. **Actualización en sitio probada de verdad**: instalar N, actualizar a N+1, y que arranque. Y
215   **rollback**, que con un store direccionado por contenido debería ser barato — es la ventaja
216   natural de esta arquitectura y conviene que sea función de primera clase.
2174. **Documentación mínima**: instalar, gestionar paquetes, reportar un fallo.
2185. **Sitio de descarga** con sumas y firmas, y las instrucciones para verificarlas.
219
220## I.5 Lo que falta de sistema para que no se note pobre
221
222Presente ya: `networkmanager`, `pipewire`, `wireplumber`, `polkit`, `seatd`, `upower`, `tzdata`,
223`fontconfig`. **Falta**: `cups` (impresión), `bluez` (bluetooth), y tipografías/locales revisados.
224
225---
226
227# PARTE II — De PUBLICABLE a «la distro está COMPLETA»
228
229Acá está el trabajo grande, y conviene decir los tamaños en voz alta.
230
231## II.1 WMs Wayland ligeros — ✅ HECHO EN UNA NOCHE (2026-08-07/08)
232> **Actualizado.** Esta sección decía «medido: no hay ninguno — de toda la familia sólo existen
233> `foot` y `mako`». Ya no. La hipótesis que traía —«son baratos comparados con los escritorios
234> completos: no hay una torre de C debajo»— **se cumplió y ahora está medida**: KDE y GNOME fueron
235> campañas de semanas; esto salió en una noche.
236
237**10 recetas selladas** en la cola `recipes/incoming-wlr/`, 12 binarios:
238
239| pieza | qué aporta |
240|---|---|
241| `wlroots` 0.18.2 | la biblioteca de la que cuelga todo lo demás |
242| `sway` 1.10 | el compositor (+ swaybar, swaymsg, swaynag) |
243| `yambar` | la barra de estado |
244| `fuzzel` | el lanzador de aplicaciones |
245| `swaybg` · `swaylock` · `swayidle` | fondo, bloqueo (con PAM) e inactividad |
246| `grim` · `slurp` | captura de pantalla y selección de región |
247| `wl-clipboard` | `wl-copy` / `wl-paste` |
248
249Con `foot` (ya en el corpus) como terminal, el perfil **`escritorio-sway` cierra 121/121** y
250**arranca en QEMU**: ver `docs/evidencia/sway-qemu-2026-08-08.png`.
251
252**`waybar` queda fuera POR MEDICIÓN**, no por gusto: pide `gtkmm-3.0` —GTK**3** *y* sus bindings de
253C++— más gtk-layer-shell, jsoncpp, fmt, spdlog, sigc++, date y libnl. Es el muro de GTK3 aparcado
254por diseño, con ocho recetas nuevas encima. `yambar` es C puro, del mismo autor que foot/fcft/fuzzel,
255y sus dependencias ya estaban selladas. Si algún día entra GTK3, waybar vuelve a la mesa.
256
257Faltan otros compositores (`labwc`, `river`, `niri`), que ahora son baratos porque wlroots ya está.
258
259### ⚠️ LA LECCIÓN QUE VALE PARA TODO ESTE DOCUMENTO: **sellado ≠ arranca**
260El grafo decía **121/121, falta 0** — y entre eso y una pantalla con algo dibujado hubo **seis muros
261y ocho ciclos de imagen**. Ninguno era visible en un grafo de dependencias, porque ninguno es una
262dependencia de build:
263
2641. **`PATH` vacío** — el `console-getty` no lo exporta; ni `mkdir` se encontraba.
2652. **`libz.so.1` ausente del rootfs** — el `zlib` del corpus es sólo estático y la compartida vive
266   en otra cola. Se cazó comparando los `NEEDED` del ELF contra el rootfs.
2673. **`LIBSEAT_BACKEND=builtin` no existe en NUESTRO libseat** — la receta lo construye con un solo
268   backend. *La receta manda sobre lo que uno cree recordar del proyecto.*
2694. **`/run` de sólo lectura** — la raíz es inmutable por diseño; el error («check permissions»)
270   sonaba a permisos y era un filesystem read-only.
2715. **`xkeyboard-config` ausente** — sin los datos XKB, xkbcommon aborta.
2726. **Sin tipografías no hay terminal** — `fcft: failed to load primary fonts`.
273
274Y el método: **el veredicto es contar colores del PPM, no leer el log.** Hubo un arranque con TODO
275verde —salida activada, modo correcto, «Commit of 1 outputs succeeded», workspace creado— y la
276captura **100% negra**. Un compositor puede estar vivo y no pintar nada.
277
278⇒ **Corolario para §4.1 y para cualquier estimación de este documento**: que un perfil cierre en el
279grafo prueba que la imagen SE ARMA, no que ARRANQUE. Los otros perfiles no validados en metal
280cargan esa misma distancia, y conviene no prometer fechas contra el número del grafo.
281
282## II.2 Aplicaciones gráficas de terceros — **medido: cero**
283No hay ni una. Por coste creciente:
284
285- **Barato** (y es lo que hace que la distro se sienta usable): visor de imágenes (`imv`), lector PDF
286  (`zathura`), reproductor (`mpv`), gestor de archivos, editor de texto gráfico, emulador de terminal
287  adicional (`alacritty`, `kitty`).
288- **Caro**: **LibreOffice**.
289- **El más caro de todo el catálogo**: **un navegador**. Firefox es Rust + C++ + su propio sistema de
290  build, y arrastra cbindgen, nasm, nodejs y una cadena de `*-sys` con C++ — que es **justo la
291  frontera que el techo MSRV del sandbox (1.96) no cruza todavía**. Presupuestarlo como un frente
292  propio, no como «una receta más».
293
294## II.3 Deuda técnica de fondo que conviene cerrar antes de crecer
295
296- **Las 16 recetas con `compiler = "gcc"`** (contadas parseando TOML; `grep` cuenta comentarios).
297  Las 12 de Rust son **un solo problema**: falta el unwinder de libgcc.
298- **No-determinismo en 92 paquetes**, todos por rutas `/src` incrustadas en secciones `.debug_*`. El
299  arreglo (`-ffile-prefix-map` global) re-hashea ~720 recetas: decisión de arquitectura, no remiendo.
300- **La carrera del árbol de fuentes (ADR 0012)**, pendiente y **sin decidir**: dos builds de la misma
301  dependencia se pisan. Aviso registrado: *un lock sólo en la extracción parece correcto y NO lo es.*
302- **El multi-init**: los inits del catálogo **compiten** con arje-zero, no se apilan.
303
304## II.4 Sostenibilidad — lo que decide si sobrevive al primer mes
305Versionado y cadencia escritos; **reconstrucción desde cero en una máquina limpia, cronometrada** —
306la prueba de que el proyecto no depende de un laptop concreto, que es exactamente la preocupación que
307originó el respaldo del 2026-08-07.
308
309---
310
311# PARTE III — El resumen ejecutivo
312
313**Para PUBLICABLE falta, en una línea cada uno:**
314
3151. Arreglar el entorno del worker → caen las 12 recetas en deuda.
3162. Terminar las licencias (913) e inyectar el texto en `hammer pack`.
3173. Montar el espejo de fuentes.
3184. Clave raíz fuera de línea y procedimiento de rotación.
3195. Imagen validada en metal (re-quemar el USB).
3206. Actualización N→N+1 probada, con rollback.
3217. Espejo de paquetes (~30 G separando `-debug`), sitio, sumas y firmas.
3228. `cups` y `bluez`.
3239. Documentación mínima y un canal de reportes.
324
325**Se puede publicar SIN**: navegador propio, ofimática, y el reconstructor independiente. Son
326objetivos, no requisitos.
327
328**Para COMPLETA falta, además**: el juego de aplicaciones gráficas, LibreOffice, el navegador, y
329cerrar la deuda de fondo (gcc, determinismo `.debug_`, ADR 0012).
330*(Los WMs ligeros ya NO están en esta lista: wlroots + sway + accesorios se cerraron el 2026-08-07/08
331y el perfil arranca en QEMU — ver §II.1. También faltan otros compositores, pero ahora son baratos.)*
332
333---
334
335## 7. Lo que este documento NO puede decirte
336
337Todos los números de acá salen del grafo, y el grafo tiene un límite que conviene tener presente
338antes de leerlo como un plan: **prueba que una imagen SE ARMA, no que ARRANQUE.**
339
340Está medido, no supuesto. El perfil `escritorio-sway` cerró **121/121, falta 0** — y entre eso y una
341pantalla con algo dibujado hubo **seis muros y ocho ciclos de imagen**: PATH vacío, un `.so`
342ausente del rootfs, un backend de libseat que nuestra receta no construye, `/run` de sólo lectura,
343los datos XKB, y la falta de tipografías. Ninguno era una dependencia de build, así que ninguno podía
344aparecer en el grafo.
345
346⇒ Cuando este documento diga que algo «cierra», leelo como *se puede intentar*, no como *funciona*.
347La distancia se paga una vez por perfil y se paga entera. Los tres escritorios que aún no se
348validaron con pantalla la deben.
349
350---
351
352## 8. Por qué `escritorio-kde` está en 76/162 — diagnóstico (2026-08-08)
353
354**No es daño de la campaña del split**, y tampoco es un fallo de `store-gc`. Es más simple y más
355incómodo: **esos artefactos no existen en ninguna parte**.
356
357### Lo que se midió, en orden
3581. **86 nodos del perfil sin artefacto en su hash vigente.**
3592. **No lo causó el split**: se revirtieron una por una todas las recetas tocadas hoy —las 3
360   bibliotecas base, las 30 hojas, `dbus`, las 38 de la 2ª tanda— y el número **no se movió**.
3613. **La FRONTERA de la deriva son 7 recetas** (las únicas cuyas deps sí están al día):
362   `dbus`, `libnl`, `libpcap`, `libxkbcommon`, `lm-sensors`, `perl-xml-parser`, `vulkan-loader`.
363   Las otras 79 cuelgan de ellas.
3644. **Las 7 son SOMBRAS de `incoming-kde`**, no las canónicas. Las del corpus están perfectamente al
365   día — por eso el problema es invisible desde el grafo del corpus.
3665. **No fue `store-gc`**: sus hashes vigentes no figuran en ningún manifiesto de borrado, y tres de
367   ellas (`libpcap`, `lm-sensors`, `vulkan-loader`) nunca se podaron.
3686. **Ni el hub ni el worker los tienen.** No están «en otro sitio»: no están.
369
370### La causa de fondo, y por qué importa más que KDE
371La cola KDE se construyó en workers EFÍMEROS. El sync del store es **unidireccional** (worker→hub) y
372esos workers ya no existen. Cuando algo del sustrato compartido cambió después de aquella campaña,
373las sombras de KDE se re-hashearon y **nadie las reconstruyó**, porque el hub nunca fue la máquina
374donde vivía ese escritorio.
375
376⇒ **Con flota efímera y sync unidireccional, un escritorio puede dejar de ser reconstruible-desde-el-
377store sin que ningún indicador lo diga.** El grafo seguía reportando 162/162 en un JSON generado
378semanas antes, y sólo se vio al regenerarlo.
379
380### Qué cuesta arreglarlo
381**86 reconstrucciones en la granja**, empezando por las 7 de la frontera. No hay muro técnico
382conocido: son recetas que ya construyeron alguna vez. Es tiempo de cómputo, no investigación.

20-catalogo-publicable-y-completa.md

SDD 20 — El catálogo de lo que falta: hasta PUBLICABLE y hasta COMPLETA

Escrito 2026-08-07, a pedido del usuario: «el catálogo de todo lo que falta hasta decir la distro está publicable, y lo de más hasta la distro está completa».

Este documento es el inventario. El SDD 21 es el manual de a pie: qué tiene que hacer el usuario, en qué orden, en cada una de las tres etapas.

Todo lo de acá está medido contra el repo el 2026-08-07, no estimado de memoria. Donde hay un número, hay un comando que lo produjo.


Los dos codos, y por qué están donde están

La distancia entre los dos codos es enorme y el orden importa: casi todo lo caro (navegador, ofimática) está DESPUÉS del primer codo, y casi todo lo bloqueante (legal, claves, actualización) está ANTES. La trampa clásica es invertirlos — pasarse meses con el navegador y descubrir el día del anuncio que no se puede publicar.


PARTE I — Hasta «la distro está PUBLICABLE»

I.1 Estado de construcción: esto ya está casi cerrado

Medido con docs/state/build-state*.json (el grafo, no recuento a mano):

frentenodosselladosen deuda
corpus77175912
KDE96895212
GNOME85384013
COSMIC81880612

Los perfiles base (51 nodos) y cli (74 nodos) están al 100%, deuda 0.

⚠️ CORREGIDO 2026-08-08. Este párrafo decía «KDE cierra 162/162». Falso: regenerado el grafo, escritorio-kde está en 76/162, y lo está en todos los commits recientes — o sea que ya lo estaba cuando se escribió esta frase. El error fue leer docs/state/build-state-kde.json sin regenerarlo: es un fichero GENERADO, y un generado que no se regenera es una foto vieja con aspecto de dato fresco. En total hay 198 recetas de las colas de escritorio (KDE 133, GNOME 37, COSMIC 24) sin artefacto en su hash vigente.

Se verificó que NO lo causó la campaña del split (SDD 23): se revirtieron una por una todas las recetas tocadas —las 3 bibliotecas base, las 30 hojas, dbus, las 38 de la 2ª tanda— y el número no se movió de 198 en ningún caso.

La deuda real es una sola lista de 12 recetas, compartida por todos los frentes (por eso el número se repite: es el mismo agujero visto desde cuatro grafos):

gtk4  libadwaita  gtksourceview  gtk4-hello  adwaita-hello  sourceview-hello
hammer-edit  mirada-compositor  mirada-greeter  dwarves  llimphi-counter  wlr-randr

⚠️ CORREGIDO EL MISMO DÍA, MIDIENDO CONTRA EL WORKER

La primera versión de esta sección decía que las 12 «fallan en el worker por su rootfs: python OSError en meson, find_package en cmake» y que el arreglo era declarar las herramientas en [deps]. Se probó y es falso. cmake y meson corren perfectamente en el worker. Las causas son cuatro, distintas, y ninguna es el rootfs. Se descubrió al construirlas de verdad en vez de heredar el diagnóstico.

(a) Seis están bloqueadas por el muro del PIC — y el frente GNOME ya lo venció por otro camino. gtk4 del corpus es link = "static" y enlaza libfontconfig.a, que tiene 1122 reubicaciones no-PIC: el enlace produce 13 032 errores relocation R_X86_64_64 cannot be used against local symbol. No es una receta rota, es una imposibilidad estructural. Mientras tanto recipes/incoming-gnome/gtk4.toml —link = "dynamic" con las deps -shared— está sellada, y con ella libadwaita y fontconfig-shared. ⇒ La cadena del corpus (gtk4, libadwaita, gtksourceview, gtk4-hello, adwaita-hello, sourceview-hello, hammer-edit) es un duplicado superado de la cadena dinámica de GNOME. Cerrarla no es «construirla»: es decidir si se promueven las sombras -shared al corpus, porque la resolución de deps es hermano→padre y una receta del corpus no ve a las de incoming-gnome. Es una decisión de arquitectura, no una tarea — y hay un aviso registrado de que promover a ciegas hace que variantes homónimas pisen recetas canónicas.

(b) wlr-randr — ✅ CERRADA HOY. Le faltaban dos deps: python3 (porque meson es un script de Python; sin intérprete la fase muere con exit 127, que se lee como «meson no está») y libffi (que la receta no usa: lo exige wayland-client.pc en su Requires). Auditadas las 1141 recetas, era la única con meson y sin python3.

(c) dwarves — frente propio, no deuda. Falla porque nuestro elfutils entrega sólo libelf, deliberadamente: libdw arrastra argp/obstack/fts, «lo verdaderamente difícil en musl». Y no se arregla ampliando elfutils, porque de él cuelga el kernel que ya reproduce bit a bit; el camino correcto es una receta aparte elfutils-libdw. Sin urgencia: ningún perfil lo pide y el kernel desactiva DEBUG_INFO_BTF explícitamente por su ausencia. Se desbloquea cuando se quiera sched-ext.

(d) mirada-compositor, mirada-greeter, llimphi-counter — HUB-ONLY estructural. Su source es gitea@git.tawasuyu.net:... por SSH y el worker es sin secretos por diseño. No es un fallo. llimphi-counter ni siquiera llega a construir: su commit es literalmente ceros, con el comentario «fijar al commit real» — es una receta sin terminar, y es de tawasuyu.

Y el hallazgo de fondo: nadie las estaba intentando

El bucle del worker recorre QUEUES="recipes/incoming recipes/incoming-go recipes/incoming-clib recipes/incoming-gnome-onda1 recipes/incoming-gnome-onda2 recipes/incoming-gnome recipes/incoming-kde" — el corpus (recipes/) no está en la lista. Las 12 nunca se habían intentado en el worker. Buena parte de «la deuda» era de encolado, no técnica.

I.2 🚨 Lo legal — bloqueante

Licencias: de 0 a 1063 de 1141 en un día

El 2026-08-07 se midió: 0 de 1141 recetas declaraban licencia. (El informe previo decía «5 de 771»; los dos números estaban mal — los «5» eran falsos positivos de grep license: el paquete addlicense, el paquete cargo-bundle-licenses, una línea de install y un comentario.)

Ese mismo día se hizo lo estructural:

Estado al cierre del día: 1063 de 1141 (93%). Cuatro escalones de evidencia, de peor a mejor: nombre (prohibido) → URL de fuente (familias) → API de licencias de GitHub → Cargo.toml del autor al tag exacto. Faltan 78. Falta también desambiguar ~55 SPDX obsoletos (GPL-3.0 no dice si es -only u -or-later), que es trabajo humano: hay que leer cabeceras de fuentes.

El cierre definitivo, para que la deuda no vuelva a abrirse con cada receta nueva, es capturar la licencia en la fase de fetch, que ya descarga y extrae cada tarball: ahí el dato pasa gratis.

⚠️ La regla que no se rompe: no se rellena a ojo. Declarar mal una licencia es peor que dejarla vacía — convierte un hueco visible en una afirmación falsa. Concretamente se descartó el atajo «k* = KDE ⇒ LGPL»: en este catálogo kail, kind, ko, kopia, krew, kustomize, kyverno y toda la familia kube* son herramientas Go sin relación con KDE.

El texto de la licencia dentro del paquete — ✅ HECHO (y no donde yo dije)

CORRECCIÓN. Esto decía «va en hammer pack». El razonamiento del coste era correcto —las fases SÍ entran al hash, así que hacerlo en la receta re-hashearía las 1141— pero el sitio estaba mal: pack produce un .swm, una receta de transformación sobre fuente pública que por diseño «NUNCA transporta binarios cocidos», e install REPRODUCE construyendo. El canal de paquetes de hammer no distribuye binarios. Donde sí se entrega un binario es en la imagen instalable, y ahí se hace ahora: scripts/licencias-rootfs.sh escribe /usr/share/licenses/<pkg>/ con el texto canónico de cada licencia de la expresión, más un MANIFEST.tsv (1,0 MB para el perfil cli). Los 44 textos SPDX viven en licenses/.

Y VETA: sale ≠0 si un paquete del rootfs no declara licencia. Al estrenarlo reveló que base y cli llevaban 10 y 12 paquetes con binarios y licencia desconocida; hoy van 2 cada uno (lsof y tzdata, que necesitan la vía LicenseRef- y siguen vetando a propósito).

Espejo de fuentes — la obligación que más se malentiende

La GPL no pide «que el código exista en internet»: pide que quien recibe el binario pueda obtener de nosotros la fuente correspondiente. Hoy las recetas apuntan a URLs de terceros que se caen.

Acá estamos inusualmente bien parados: cada receta pinea tarball + sha256, así que el espejo es mecánico y encima verificable. Pero tiene que existir antes de la primera descarga.

Imágenes ajenas (qorpa): fuera del catálogo, y por escrito

Desde el ADR 0015 hay una segunda cadena de suministro: rootfs de otras distros que corren enjaulados. No entran en el catálogo publicable ni en el reporte de licencias, y la razón no es pereza: no podemos enumerarlas. Un dnf install o un pacman -S dentro de una instancia trae paquetes que nadie declaró acá, y afirmar una licencia sobre eso sería inventarla.

Lo que sí se hace, y alcanza:

Novedad 2026-09-04, y no rompe nada de lo anterior: una de ellas YA está sellada al store. El runtime sniper de Valve entra por recipes/steam-runtime-sniper.toml porque no muta —nadie le instala nada adentro—, así que el mismo tarball pineado da siempre el mismo árbol. Sigue fuera del catálogo publicable y del reporte de licencias: su receta lleva foreign = true, el grafo la clasifica ajeno y su license es un LicenseRef-…-no-enumerable explícito, que dice lo que hay —cientos de paquetes Debian que no podemos enumerar— en vez de dejar el campo vacío, que se leería como «todavía no la poblamos». Y la distinción del punto anterior sigue en pie con más filo: replicarla a nuestras propias máquinas con hammer mirror push es lo mismo que ya hace el ADR 0013 con las fuentes; publicarla a terceros sigue pidiendo mirar licencia y marca antes, y eso no es una pregunta técnica.

⚠️ Y el corolario que hay que escribir donde se lea: el claim «hammer reproduce bit a bit» hay que acotarlo desde el día que exista una instancia — el sistema base reproduce; las instancias ajenas no, y se declaran como tales. Sin eso, la cultura de números honestos se erosiona sola.

Marcas

Redistribuir Firefox con su nombre y logo exige cumplir la política de marca de Mozilla (por eso Debian tuvo Iceweasel). Decidir por adelantado: cumplir o rebrandear. No bloquea el primer lanzamiento si se sale sin navegador propio.

La licencia de hammer — ✅ ya está

LICENSE en la raíz y license = "MIT" en Cargo.toml. (El SDD 19 decía que faltaba; era falso.)

I.3 Infraestructura pública

  1. Espejo de paquetes e imágenes. Dimensionado real: el store son 128 G, pero ~60% es información de depuración ⇒ separando -debug en paquetes aparte el espejo baja a ~51 G (medido en la etapa 3 del SDD 23; el «79%» que se citaba era sobre el CONTENIDO BINARIO, no sobre el tamaño de artefacto).
  2. Cadena de firma de release. Hoy hay firma de índice. Falta el nivel de arriba: clave raíz fuera de línea, claves de firma rotables y un procedimiento escrito para cuando se filtre una. Firma sin gestión de claves es teatro.
  3. Evidencia de reproducibilidad publicada. Es el diferenciador: publicar junto a cada imagen los ArtifactHash de toda su clausura, para que un tercero reconstruya y compare. Es lo que convierte «somos reproducibles» en un hecho comprobable por un extraño.
  4. Respuesta a seguridad: un canal para reportes y —lo importante— la capacidad demostrada de empujar una actualización y que llegue. Ensayar el ciclo completo con un CVE de mentira.

I.4 Que se pueda instalar y usar

  1. Imagen instalable validada en METAL, no sólo en QEMU. Está a medio camino: el USB de KDE en metal está en curso y falta re-quemarlo. Reglas ya pagadas caro: validar imágenes de escritorio con pantalla, nunca sólo -nographic; /dev/console es el serial, así que cada capa debe escribir a /dev/tty0; y nunca quemar a un NVMe.
  2. Matriz de hardware honesta: en qué se probó y en qué no. Vale más «probado en estas 3 máquinas» que «debería funcionar».
  3. Actualización en sitio probada de verdad: instalar N, actualizar a N+1, y que arranque. Y rollback, que con un store direccionado por contenido debería ser barato — es la ventaja natural de esta arquitectura y conviene que sea función de primera clase.
  4. Documentación mínima: instalar, gestionar paquetes, reportar un fallo.
  5. Sitio de descarga con sumas y firmas, y las instrucciones para verificarlas.

I.5 Lo que falta de sistema para que no se note pobre

Presente ya: networkmanager, pipewire, wireplumber, polkit, seatd, upower, tzdata, fontconfig. Falta: cups (impresión), bluez (bluetooth), y tipografías/locales revisados.


PARTE II — De PUBLICABLE a «la distro está COMPLETA»

Acá está el trabajo grande, y conviene decir los tamaños en voz alta.

II.1 WMs Wayland ligeros — ✅ HECHO EN UNA NOCHE (2026-08-07/08)

Actualizado. Esta sección decía «medido: no hay ninguno — de toda la familia sólo existen foot y mako». Ya no. La hipótesis que traía —«son baratos comparados con los escritorios completos: no hay una torre de C debajo»— se cumplió y ahora está medida: KDE y GNOME fueron campañas de semanas; esto salió en una noche.

10 recetas selladas en la cola recipes/incoming-wlr/, 12 binarios:

piezaqué aporta
wlroots 0.18.2la biblioteca de la que cuelga todo lo demás
sway 1.10el compositor (+ swaybar, swaymsg, swaynag)
yambarla barra de estado
fuzzelel lanzador de aplicaciones
swaybg · swaylock · swayidlefondo, bloqueo (con PAM) e inactividad
grim · slurpcaptura de pantalla y selección de región
wl-clipboardwl-copy / wl-paste

Con foot (ya en el corpus) como terminal, el perfil escritorio-sway cierra 121/121 y arranca en QEMU: ver docs/evidencia/sway-qemu-2026-08-08.png.

waybar queda fuera POR MEDICIÓN, no por gusto: pide gtkmm-3.0 —GTK3 y sus bindings de C++— más gtk-layer-shell, jsoncpp, fmt, spdlog, sigc++, date y libnl. Es el muro de GTK3 aparcado por diseño, con ocho recetas nuevas encima. yambar es C puro, del mismo autor que foot/fcft/fuzzel, y sus dependencias ya estaban selladas. Si algún día entra GTK3, waybar vuelve a la mesa.

Faltan otros compositores (labwc, river, niri), que ahora son baratos porque wlroots ya está.

⚠️ LA LECCIÓN QUE VALE PARA TODO ESTE DOCUMENTO: sellado ≠ arranca

El grafo decía 121/121, falta 0 — y entre eso y una pantalla con algo dibujado hubo seis muros y ocho ciclos de imagen. Ninguno era visible en un grafo de dependencias, porque ninguno es una dependencia de build:

  1. PATH vacío — el console-getty no lo exporta; ni mkdir se encontraba.
  2. libz.so.1 ausente del rootfs — el zlib del corpus es sólo estático y la compartida vive en otra cola. Se cazó comparando los NEEDED del ELF contra el rootfs.
  3. LIBSEAT_BACKEND=builtin no existe en NUESTRO libseat — la receta lo construye con un solo backend. La receta manda sobre lo que uno cree recordar del proyecto.
  4. /run de sólo lectura — la raíz es inmutable por diseño; el error («check permissions») sonaba a permisos y era un filesystem read-only.
  5. xkeyboard-config ausente — sin los datos XKB, xkbcommon aborta.
  6. Sin tipografías no hay terminal — fcft: failed to load primary fonts.

Y el método: el veredicto es contar colores del PPM, no leer el log. Hubo un arranque con TODO verde —salida activada, modo correcto, «Commit of 1 outputs succeeded», workspace creado— y la captura 100% negra. Un compositor puede estar vivo y no pintar nada.

⇒ Corolario para §4.1 y para cualquier estimación de este documento: que un perfil cierre en el grafo prueba que la imagen SE ARMA, no que ARRANQUE. Los otros perfiles no validados en metal cargan esa misma distancia, y conviene no prometer fechas contra el número del grafo.

II.2 Aplicaciones gráficas de terceros — medido: cero

No hay ni una. Por coste creciente:

II.3 Deuda técnica de fondo que conviene cerrar antes de crecer

II.4 Sostenibilidad — lo que decide si sobrevive al primer mes

Versionado y cadencia escritos; reconstrucción desde cero en una máquina limpia, cronometrada — la prueba de que el proyecto no depende de un laptop concreto, que es exactamente la preocupación que originó el respaldo del 2026-08-07.


PARTE III — El resumen ejecutivo

Para PUBLICABLE falta, en una línea cada uno:

  1. Arreglar el entorno del worker → caen las 12 recetas en deuda.
  2. Terminar las licencias (913) e inyectar el texto en hammer pack.
  3. Montar el espejo de fuentes.
  4. Clave raíz fuera de línea y procedimiento de rotación.
  5. Imagen validada en metal (re-quemar el USB).
  6. Actualización N→N+1 probada, con rollback.
  7. Espejo de paquetes (~30 G separando -debug), sitio, sumas y firmas.
  8. cups y bluez.
  9. Documentación mínima y un canal de reportes.

Se puede publicar SIN: navegador propio, ofimática, y el reconstructor independiente. Son objetivos, no requisitos.

Para COMPLETA falta, además: el juego de aplicaciones gráficas, LibreOffice, el navegador, y cerrar la deuda de fondo (gcc, determinismo .debug_, ADR 0012). (Los WMs ligeros ya NO están en esta lista: wlroots + sway + accesorios se cerraron el 2026-08-07/08 y el perfil arranca en QEMU — ver §II.1. También faltan otros compositores, pero ahora son baratos.)


7. Lo que este documento NO puede decirte

Todos los números de acá salen del grafo, y el grafo tiene un límite que conviene tener presente antes de leerlo como un plan: prueba que una imagen SE ARMA, no que ARRANQUE.

Está medido, no supuesto. El perfil escritorio-sway cerró 121/121, falta 0 — y entre eso y una pantalla con algo dibujado hubo seis muros y ocho ciclos de imagen: PATH vacío, un .so ausente del rootfs, un backend de libseat que nuestra receta no construye, /run de sólo lectura, los datos XKB, y la falta de tipografías. Ninguno era una dependencia de build, así que ninguno podía aparecer en el grafo.

⇒ Cuando este documento diga que algo «cierra», leelo como se puede intentar, no como funciona. La distancia se paga una vez por perfil y se paga entera. Los tres escritorios que aún no se validaron con pantalla la deben.


8. Por qué escritorio-kde está en 76/162 — diagnóstico (2026-08-08)

No es daño de la campaña del split, y tampoco es un fallo de store-gc. Es más simple y más incómodo: esos artefactos no existen en ninguna parte.

Lo que se midió, en orden

  1. 86 nodos del perfil sin artefacto en su hash vigente.
  2. No lo causó el split: se revirtieron una por una todas las recetas tocadas hoy —las 3 bibliotecas base, las 30 hojas, dbus, las 38 de la 2ª tanda— y el número no se movió.
  3. La FRONTERA de la deriva son 7 recetas (las únicas cuyas deps sí están al día): dbus, libnl, libpcap, libxkbcommon, lm-sensors, perl-xml-parser, vulkan-loader. Las otras 79 cuelgan de ellas.
  4. Las 7 son SOMBRAS de incoming-kde, no las canónicas. Las del corpus están perfectamente al día — por eso el problema es invisible desde el grafo del corpus.
  5. No fue store-gc: sus hashes vigentes no figuran en ningún manifiesto de borrado, y tres de ellas (libpcap, lm-sensors, vulkan-loader) nunca se podaron.
  6. Ni el hub ni el worker los tienen. No están «en otro sitio»: no están.

La causa de fondo, y por qué importa más que KDE

La cola KDE se construyó en workers EFÍMEROS. El sync del store es unidireccional (worker→hub) y esos workers ya no existen. Cuando algo del sustrato compartido cambió después de aquella campaña, las sombras de KDE se re-hashearon y nadie las reconstruyó, porque el hub nunca fue la máquina donde vivía ese escritorio.

⇒ Con flota efímera y sync unidireccional, un escritorio puede dejar de ser reconstruible-desde-el- store sin que ningún indicador lo diga. El grafo seguía reportando 162/162 en un JSON generado semanas antes, y sólo se vio al regenerarlo.

Qué cuesta arreglarlo

86 reconstrucciones en la granja, empezando por las 7 de la frontera. No hay muro técnico conocido: son recetas que ya construyeron alguna vez. Es tiempo de cómputo, no investigación.