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