tawasuyu

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 1384Shell 121Rust 74Markdown 651928 Definiciones

⎇ 6c37df6fa41ec3faa8e1440f18e861b078a06104 docs/20-catalogo-publicable-y-completa.md Markdown · 371 líneas · 22.5 KB Historia crudo

qorpa prune: la poda nace con el subsistema, no después d77ad15d0 · 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⚠️ Y el corolario que hay que escribir donde se lea: **el claim «hammer reproduce bit a bit» hay que
172acotarlo** desde el día que exista una instancia — *el sistema base reproduce; las instancias ajenas
173no, y se declaran como tales*. Sin eso, la cultura de números honestos se erosiona sola.
174
175### Marcas
176Redistribuir Firefox con su nombre y logo exige cumplir la política de marca de Mozilla (por eso
177Debian tuvo Iceweasel). Decidir por adelantado: cumplir o rebrandear. **No bloquea el primer
178lanzamiento** si se sale sin navegador propio.
179
180### La licencia de hammer — ✅ ya está
181`LICENSE` en la raíz y `license = "MIT"` en `Cargo.toml`. *(El SDD 19 decía que faltaba; era falso.)*
182
183## I.3 Infraestructura pública
184
1851. **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).
1862. **Cadena de firma de release.** Hoy hay firma de índice. Falta el nivel de arriba: **clave raíz
187   fuera de línea**, claves de firma rotables y un procedimiento escrito para cuando se filtre una.
188   Firma sin gestión de claves es teatro.
1893. **Evidencia de reproducibilidad publicada.** Es *el* diferenciador: publicar junto a cada imagen
190   los `ArtifactHash` de toda su clausura, para que un tercero reconstruya y compare. Es lo que
191   convierte «somos reproducibles» en un hecho comprobable por un extraño.
1924. **Respuesta a seguridad**: un canal para reportes y —lo importante— la capacidad **demostrada** de
193   empujar una actualización y que llegue. Ensayar el ciclo completo con un CVE de mentira.
194
195## I.4 Que se pueda instalar y usar
196
1971. **Imagen instalable validada en METAL**, no sólo en QEMU. Está a medio camino: el USB de KDE en
198   metal está **en curso** y falta re-quemarlo. Reglas ya pagadas caro: validar imágenes de
199   escritorio **con pantalla**, nunca sólo `-nographic`; `/dev/console` es el serial, así que cada
200   capa debe escribir a `/dev/tty0`; y **nunca quemar a un NVMe**.
2012. **Matriz de hardware honesta**: en qué se probó y en qué no. Vale más «probado en estas 3
202   máquinas» que «debería funcionar».
2033. **Actualización en sitio probada de verdad**: instalar N, actualizar a N+1, y que arranque. Y
204   **rollback**, que con un store direccionado por contenido debería ser barato — es la ventaja
205   natural de esta arquitectura y conviene que sea función de primera clase.
2064. **Documentación mínima**: instalar, gestionar paquetes, reportar un fallo.
2075. **Sitio de descarga** con sumas y firmas, y las instrucciones para verificarlas.
208
209## I.5 Lo que falta de sistema para que no se note pobre
210
211Presente ya: `networkmanager`, `pipewire`, `wireplumber`, `polkit`, `seatd`, `upower`, `tzdata`,
212`fontconfig`. **Falta**: `cups` (impresión), `bluez` (bluetooth), y tipografías/locales revisados.
213
214---
215
216# PARTE II — De PUBLICABLE a «la distro está COMPLETA»
217
218Acá está el trabajo grande, y conviene decir los tamaños en voz alta.
219
220## II.1 WMs Wayland ligeros — ✅ HECHO EN UNA NOCHE (2026-08-07/08)
221> **Actualizado.** Esta sección decía «medido: no hay ninguno — de toda la familia sólo existen
222> `foot` y `mako`». Ya no. La hipótesis que traía —«son baratos comparados con los escritorios
223> completos: no hay una torre de C debajo»— **se cumplió y ahora está medida**: KDE y GNOME fueron
224> campañas de semanas; esto salió en una noche.
225
226**10 recetas selladas** en la cola `recipes/incoming-wlr/`, 12 binarios:
227
228| pieza | qué aporta |
229|---|---|
230| `wlroots` 0.18.2 | la biblioteca de la que cuelga todo lo demás |
231| `sway` 1.10 | el compositor (+ swaybar, swaymsg, swaynag) |
232| `yambar` | la barra de estado |
233| `fuzzel` | el lanzador de aplicaciones |
234| `swaybg` · `swaylock` · `swayidle` | fondo, bloqueo (con PAM) e inactividad |
235| `grim` · `slurp` | captura de pantalla y selección de región |
236| `wl-clipboard` | `wl-copy` / `wl-paste` |
237
238Con `foot` (ya en el corpus) como terminal, el perfil **`escritorio-sway` cierra 121/121** y
239**arranca en QEMU**: ver `docs/evidencia/sway-qemu-2026-08-08.png`.
240
241**`waybar` queda fuera POR MEDICIÓN**, no por gusto: pide `gtkmm-3.0` —GTK**3** *y* sus bindings de
242C++— más gtk-layer-shell, jsoncpp, fmt, spdlog, sigc++, date y libnl. Es el muro de GTK3 aparcado
243por diseño, con ocho recetas nuevas encima. `yambar` es C puro, del mismo autor que foot/fcft/fuzzel,
244y sus dependencias ya estaban selladas. Si algún día entra GTK3, waybar vuelve a la mesa.
245
246Faltan otros compositores (`labwc`, `river`, `niri`), que ahora son baratos porque wlroots ya está.
247
248### ⚠️ LA LECCIÓN QUE VALE PARA TODO ESTE DOCUMENTO: **sellado ≠ arranca**
249El grafo decía **121/121, falta 0** — y entre eso y una pantalla con algo dibujado hubo **seis muros
250y ocho ciclos de imagen**. Ninguno era visible en un grafo de dependencias, porque ninguno es una
251dependencia de build:
252
2531. **`PATH` vacío** — el `console-getty` no lo exporta; ni `mkdir` se encontraba.
2542. **`libz.so.1` ausente del rootfs** — el `zlib` del corpus es sólo estático y la compartida vive
255   en otra cola. Se cazó comparando los `NEEDED` del ELF contra el rootfs.
2563. **`LIBSEAT_BACKEND=builtin` no existe en NUESTRO libseat** — la receta lo construye con un solo
257   backend. *La receta manda sobre lo que uno cree recordar del proyecto.*
2584. **`/run` de sólo lectura** — la raíz es inmutable por diseño; el error («check permissions»)
259   sonaba a permisos y era un filesystem read-only.
2605. **`xkeyboard-config` ausente** — sin los datos XKB, xkbcommon aborta.
2616. **Sin tipografías no hay terminal** — `fcft: failed to load primary fonts`.
262
263Y el método: **el veredicto es contar colores del PPM, no leer el log.** Hubo un arranque con TODO
264verde —salida activada, modo correcto, «Commit of 1 outputs succeeded», workspace creado— y la
265captura **100% negra**. Un compositor puede estar vivo y no pintar nada.
266
267⇒ **Corolario para §4.1 y para cualquier estimación de este documento**: que un perfil cierre en el
268grafo prueba que la imagen SE ARMA, no que ARRANQUE. Los otros perfiles no validados en metal
269cargan esa misma distancia, y conviene no prometer fechas contra el número del grafo.
270
271## II.2 Aplicaciones gráficas de terceros — **medido: cero**
272No hay ni una. Por coste creciente:
273
274- **Barato** (y es lo que hace que la distro se sienta usable): visor de imágenes (`imv`), lector PDF
275  (`zathura`), reproductor (`mpv`), gestor de archivos, editor de texto gráfico, emulador de terminal
276  adicional (`alacritty`, `kitty`).
277- **Caro**: **LibreOffice**.
278- **El más caro de todo el catálogo**: **un navegador**. Firefox es Rust + C++ + su propio sistema de
279  build, y arrastra cbindgen, nasm, nodejs y una cadena de `*-sys` con C++ — que es **justo la
280  frontera que el techo MSRV del sandbox (1.96) no cruza todavía**. Presupuestarlo como un frente
281  propio, no como «una receta más».
282
283## II.3 Deuda técnica de fondo que conviene cerrar antes de crecer
284
285- **Las 16 recetas con `compiler = "gcc"`** (contadas parseando TOML; `grep` cuenta comentarios).
286  Las 12 de Rust son **un solo problema**: falta el unwinder de libgcc.
287- **No-determinismo en 92 paquetes**, todos por rutas `/src` incrustadas en secciones `.debug_*`. El
288  arreglo (`-ffile-prefix-map` global) re-hashea ~720 recetas: decisión de arquitectura, no remiendo.
289- **La carrera del árbol de fuentes (ADR 0012)**, pendiente y **sin decidir**: dos builds de la misma
290  dependencia se pisan. Aviso registrado: *un lock sólo en la extracción parece correcto y NO lo es.*
291- **El multi-init**: los inits del catálogo **compiten** con arje-zero, no se apilan.
292
293## II.4 Sostenibilidad — lo que decide si sobrevive al primer mes
294Versionado y cadencia escritos; **reconstrucción desde cero en una máquina limpia, cronometrada** —
295la prueba de que el proyecto no depende de un laptop concreto, que es exactamente la preocupación que
296originó el respaldo del 2026-08-07.
297
298---
299
300# PARTE III — El resumen ejecutivo
301
302**Para PUBLICABLE falta, en una línea cada uno:**
303
3041. Arreglar el entorno del worker → caen las 12 recetas en deuda.
3052. Terminar las licencias (913) e inyectar el texto en `hammer pack`.
3063. Montar el espejo de fuentes.
3074. Clave raíz fuera de línea y procedimiento de rotación.
3085. Imagen validada en metal (re-quemar el USB).
3096. Actualización N→N+1 probada, con rollback.
3107. Espejo de paquetes (~30 G separando `-debug`), sitio, sumas y firmas.
3118. `cups` y `bluez`.
3129. Documentación mínima y un canal de reportes.
313
314**Se puede publicar SIN**: navegador propio, ofimática, y el reconstructor independiente. Son
315objetivos, no requisitos.
316
317**Para COMPLETA falta, además**: el juego de aplicaciones gráficas, LibreOffice, el navegador, y
318cerrar la deuda de fondo (gcc, determinismo `.debug_`, ADR 0012).
319*(Los WMs ligeros ya NO están en esta lista: wlroots + sway + accesorios se cerraron el 2026-08-07/08
320y el perfil arranca en QEMU — ver §II.1. También faltan otros compositores, pero ahora son baratos.)*
321
322---
323
324## 7. Lo que este documento NO puede decirte
325
326Todos los números de acá salen del grafo, y el grafo tiene un límite que conviene tener presente
327antes de leerlo como un plan: **prueba que una imagen SE ARMA, no que ARRANQUE.**
328
329Está medido, no supuesto. El perfil `escritorio-sway` cerró **121/121, falta 0** — y entre eso y una
330pantalla con algo dibujado hubo **seis muros y ocho ciclos de imagen**: PATH vacío, un `.so`
331ausente del rootfs, un backend de libseat que nuestra receta no construye, `/run` de sólo lectura,
332los datos XKB, y la falta de tipografías. Ninguno era una dependencia de build, así que ninguno podía
333aparecer en el grafo.
334
335⇒ Cuando este documento diga que algo «cierra», leelo como *se puede intentar*, no como *funciona*.
336La distancia se paga una vez por perfil y se paga entera. Los tres escritorios que aún no se
337validaron con pantalla la deben.
338
339---
340
341## 8. Por qué `escritorio-kde` está en 76/162 — diagnóstico (2026-08-08)
342
343**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
344incómodo: **esos artefactos no existen en ninguna parte**.
345
346### Lo que se midió, en orden
3471. **86 nodos del perfil sin artefacto en su hash vigente.**
3482. **No lo causó el split**: se revirtieron una por una todas las recetas tocadas hoy —las 3
349   bibliotecas base, las 30 hojas, `dbus`, las 38 de la 2ª tanda— y el número **no se movió**.
3503. **La FRONTERA de la deriva son 7 recetas** (las únicas cuyas deps sí están al día):
351   `dbus`, `libnl`, `libpcap`, `libxkbcommon`, `lm-sensors`, `perl-xml-parser`, `vulkan-loader`.
352   Las otras 79 cuelgan de ellas.
3534. **Las 7 son SOMBRAS de `incoming-kde`**, no las canónicas. Las del corpus están perfectamente al
354   día — por eso el problema es invisible desde el grafo del corpus.
3555. **No fue `store-gc`**: sus hashes vigentes no figuran en ningún manifiesto de borrado, y tres de
356   ellas (`libpcap`, `lm-sensors`, `vulkan-loader`) nunca se podaron.
3576. **Ni el hub ni el worker los tienen.** No están «en otro sitio»: no están.
358
359### La causa de fondo, y por qué importa más que KDE
360La cola KDE se construyó en workers EFÍMEROS. El sync del store es **unidireccional** (worker→hub) y
361esos workers ya no existen. Cuando algo del sustrato compartido cambió después de aquella campaña,
362las sombras de KDE se re-hashearon y **nadie las reconstruyó**, porque el hub nunca fue la máquina
363donde vivía ese escritorio.
364
365⇒ **Con flota efímera y sync unidireccional, un escritorio puede dejar de ser reconstruible-desde-el-
366store sin que ningún indicador lo diga.** El grafo seguía reportando 162/162 en un JSON generado
367semanas antes, y sólo se vio al regenerarlo.
368
369### Qué cuesta arreglarlo
370**86 reconstrucciones en la granja**, empezando por las 7 de la frontera. No hay muro técnico
371conocido: 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:

⚠️ 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.