From 5447c175f9ab3d86da4222268afc5c1ee70afb01 Mon Sep 17 00:00:00 2001 From: sergio Date: Sat, 11 Jul 2026 06:53:40 -0400 Subject: [PATCH] =?UTF-8?q?docs:=20ADR=200011=20=E2=80=94=20roadmap=20camp?= =?UTF-8?q?a=C3=B1a=20escritorio=20KDE=20Plasma=206?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fija la política (capa GUI adopta linking DINÁMICO: Qt carga plugins .so en runtime, incompatible con el static-musl del userland CLI), el orden topológico en 5 capas (sustrato→Qt6→KF6→Plasma→apps), 6 hitos verificables (gate = H-Qt: qtbase + una ventana Qt bajo el régimen dinámico) y la estrategia de granja (cola aislada incoming-kde/, cadencia por capa, qtwebengine diferido). Co-Authored-By: Claude Opus 4.8 --- docs/adr/0011-escritorio-kde-plasma.md | 172 +++++++++++++++++++++++++ recipes/incoming-kde/.gitkeep | 0 2 files changed, 172 insertions(+) create mode 100644 docs/adr/0011-escritorio-kde-plasma.md create mode 100644 recipes/incoming-kde/.gitkeep diff --git a/docs/adr/0011-escritorio-kde-plasma.md b/docs/adr/0011-escritorio-kde-plasma.md new file mode 100644 index 00000000..97e0871f --- /dev/null +++ b/docs/adr/0011-escritorio-kde-plasma.md @@ -0,0 +1,172 @@ +# 0011 — Etapa Escritorio: campaña KDE Plasma 6 + +Estado: propuesto (roadmap de campaña, no implementación) +Fecha: 2026-07-11 +Relacionado: [[etapa-g-importar-nix]], [[etapa-g-gui-chain-boundary]], [[granja-efimera-hcloud]], +0003-zig-cc-builder, 0008-bootstrap-stages, 0010-arranque-grafo-mirada + +## Contexto + +El catálogo firmado tiene ~748 paquetes y ~760 recetas canónicas. En la práctica **es userland +CLI**: cadenas Rust/Go self-contained que la granja muele fácil, más un cimiento gráfico GTK +(`gtk4`/`libadwaita`/`cairo`/`pango`/`harfbuzz`/`freetype`/`fontconfig`/`mesa`/`wayland`) capaz de +correr *apps* GTK sueltas — no un escritorio. + +El objetivo de esta etapa es un **escritorio completo, booteable y usable: KDE Plasma 6**. Se eligió +KDE primero (sobre GNOME/XFCE) a pesar de ser el más caro (~600–800 recetas nuevas, C++ pesado) +porque define el techo de dificultad: si la máquina de build sobrevive a Qt+Plasma, GNOME y XFCE +son cuesta abajo y comparten casi todo el sustrato de bajo nivel. + +Este ADR **no** importa ni construye nada. Fija la política, el orden topológico, los hitos y la +estrategia de granja. La primera tanda real es un paso posterior. + +## El eje del problema: static-musl/zig-cc **vs.** el mundo Qt/KDE + +Todo el lab se construyó sobre una disciplina (ADR 0003): **link estático, musl, `zig-cc`, cierre de +deps explícito**. Eso hizo reproducibles 748 paquetes. Pero KDE es exactamente el terreno donde esa +disciplina deja de aplicar sin traducción: + +1. **Qt carga plugins `.so` en runtime.** La plataforma (QPA: `libqwayland*.so`, `libqxcb.so`), + los formatos de imagen, los estilos, los backends de multimedia — todos son bibliotecas + compartidas cargadas por `dlopen`. Un Qt "todo estático" **no arranca un escritorio**: sin el + plugin QPA no hay ventana. Esto no es una opción a desactivar como en `gtk4` (`-Dx11-backend=false`); + es la arquitectura. +2. **Plasma es una constelación de procesos + QML.** `kwin`, `plasmashell`, `krunner`, + `systemsettings`, servicios D-Bus. Comparten bibliotecas KF6/Qt6 a nivel de `.so`; estatizarlas + multiplicaría el binario por N procesos y rompería los plugins igual. +3. **C++ a escala Qt es territorio no ejercitado.** El corpus es C/Rust/Go. `zig-cc` compila C++, + pero Qt6 + KF6 es el stress-test más grande que va a ver; el zig-skew ya rompió `cairo` + (`ctime_r`) en el laptop ([[etapa-g-gui-chain-boundary]]). + +### Decisión de política + +**La capa gráfica de KDE adopta linking DINÁMICO.** Concretamente: + +- **Bibliotecas compartidas (`.so`) para Qt6, KF6 y Plasma**, con `SONAME` y `rpath`/`ld.so.conf` + soberanos. Se abandona el `-static` para esta capa; se conserva para el userland CLI ya sellado + (no se re-hashea nada existente). +- **musl dinámico como objetivo por defecto.** Si un componente pelea con musl de forma + irreducible (glibc-ismos duros), se aísla y se documenta como deuda, igual que la "deuda GL de + Alpine" que ya arrastramos ([[mirada-usb-nvidia]]). No se introduce glibc a la ligera. +- **`compiler` por componente.** `zig-cc` donde funcione; caída a `gcc`-de-gueto (el patrón ya usado + para kernel/cmake) donde el C++ de Qt lo exija. Se prueba zig primero, se documenta cada caída. +- **CMake es el sistema de build dominante** (ECM lo es todo en KDE). Ya existe `recipes/cmake.toml`. + +Esta es la decisión arquitectónica que este ADR **registra**: la etapa escritorio parte el mundo en +dos regímenes de linking, y eso es deliberado, no un accidente. + +## Lo que SÍ reusa el cimiento actual + +El preview del planeamiento dijo "reusa casi nada"; es pesimista. Qt≠GTK a nivel toolkit, pero **todo +el sustrato de bajo nivel es compartido** y ya está sellado: + +`freetype`, `fontconfig`, `harfbuzz`, `fribidi`, `pixman`, `libpng`, `libjpeg-turbo`, `libtiff`, +`expat`, `zlib`, `libffi`, `pcre2`, `libxml2`, `libxkbcommon`, `wayland`, `wayland-protocols`, +`libdrm`, `mesa`, `dbus`, `glib` (Qt puede integrarse con glib main loop). + +Es decir: la **capa 0** (abajo) ya existe en buena parte. Lo nuevo empieza en Xorg/servicios y sube. + +## Orden topológico (capas de la campaña) + +De abajo hacia arriba; cada capa es puerta de la siguiente. Números = recetas *nuevas* estimadas. + +### Capa 0 — Sustrato gráfico y de sistema (~60–120) +Lo que falta bajo Qt, mayormente C/Meson-CMake, dentro de la disciplina actual (dinámico ahora): +- **Mesa completo** (no `mesa-swrast`): DRI, Gallium, Vulkan (KWin quiere Vulkan). Hoy tenemos base. +- **Pila X11 para XWayland/xcb**: `libxcb`, `xcb-util*`, `libX11`, `libXext`, `libXi`, `libXcursor`, + `libXrandr`, `libXfixes`, `xkeyboard-config`, `xcb-util-cursor`. (Qt xcb + apps legacy vía XWayland.) +- **XWayland** + **Xorg server** (para XWayland embebido). +- **Seat/sesión**: `seatd` (ya en cola del otro agente) o **elogind** (logind sin systemd, clave en + musl), `pam`/`linux-pam` o `pam_rundir`, `polkit`. +- **Audio**: `pipewire` + `wireplumber` (Plasma 6 asume PipeWire). +- **Media** (Qt Multimedia / phonon): `ffmpeg` o `gstreamer`. +- **Cripto/red base para servicios**: `openssl` (tenemos), `NetworkManager` o `connman`, `BlueZ`. +- **Imagen/color**: `libepoxy` (tenemos), `lcm2`/`little-cms`, `libglvnd`. + +### Capa 1 — Qt 6 (~15–25 recetas, pero enormes) +El corazón. Módulos, en orden: +- `qtbase` (el mastodonte: gui, widgets, network, dbus, sql, el plugin QPA wayland+xcb). +- `qtshadertools`, `qtdeclarative` (**QML — Plasma es QML**), `qtwayland`, `qtsvg`, `qt5compat`, + `qttools`, `qtmultimedia`, `qtsensors`, `qtvirtualkeyboard`, `qtimageformats`, `qtquick3d`(opc), + `qtwebengine`(**diferible** — Chromium embebido, la receta más cara de todo el proyecto). +- Extras KDE: `qtkeychain`. + +### Capa 2 — KDE Frameworks 6 (~80 recetas, por tiers ECM) +`extra-cmake-modules` (ECM) primero — es el build-system de todo KDE. Luego por tiers de dependencia: +- **Tier 1** (sin deps entre frameworks): `kcoreaddons`, `kconfig`, `kguiaddons`, `ki18n`, + `kwidgetsaddons`, `kwindowsystem`, `kdbusaddons`, `karchive`, `kcodecs`, `kitemviews`, `solid`, + `sonnet`, `threadweaver`, `kholidays`, `prison`, `syntax-highlighting`, `breeze-icons`, `kirigami`… +- **Tier 2**: `kauth`, `kcompletion`, `kcrash`, `kdoctools`, `kjobwidgets`, `knotifications`, + `kpackage`, `kunitconversion`, `kservice`… +- **Tier 3**: `kconfigwidgets`, `kiconthemes`, `kio`, `kglobalaccel`, `ktextwidgets`, `kxmlgui`, + `kbookmarks`, `kwallet`, `knewstuff`, `kparts`, `kdeclarative`, `kcmutils`, `kdesu`, + `krunner`, `plasma-framework`/`libplasma`, `frameworkintegration`… +- **Integración**: `kwayland`, `kdnssd`, `kpeople`, `modemmanager-qt`, `networkmanager-qt`, + `bluez-qt`, `kactivities`, `baloo` (búsqueda), `purpose`. + +### Capa 3 — Plasma 6 workspace (~40–60) +- Base: `libkscreen`, `libksysguard`, `kscreenlocker`, `kglobalacceld`, `kdecoration`, + `layer-shell-qt`, `plasma-activities`, `kpipewire`. +- Compositor: **`kwin`** (Wayland; requiere Vulkan/GL, XWayland). +- Shell: `plasma-workspace` (`plasmashell`, `krunner`, `ksmserver`), `plasma-desktop`, + `plasma-pa` (audio), `plasma-nm` (red), `powerdevil`, `systemsettings`, `kmenuedit`, + `plasma-systemmonitor`, `kactivitymanagerd`, `milou`, `kscreen`, `sddm`(display manager) o + integración con el arranque-grafo-mirada (ver ADR 0010), `breeze` (tema/estilo Qt). + +### Capa 4 — Apps núcleo (opcional para "booteable", ~20–60) +`dolphin` (archivos), `konsole` (terminal), `kate`/`kwrite`, `ark`, `gwenview`, `okular`, +`spectacle`, `kcalc`, `kwalletmanager`… Se prioriza el mínimo para un escritorio *usable*, el resto +por demanda. + +## Hitos (definición de "hecho" por etapa, verificable) + +1. **H-Qt**: `qtbase` construye + un binario Qt trivial (`QApplication` + `QLabel`) **abre una + ventana** sobre el compositor de referencia (mirada/QEMU). Prueba que el régimen dinámico + QPA + wayland funciona end-to-end. *Sin esto, nada de KDE tiene sentido — es el gate real.* +2. **H-QML**: una app `qtdeclarative` (QML) renderiza. Plasma es QML; este hito de-riskea la capa 3. +3. **H-KF6**: ECM + tier 1 + `kio` construyen; una app KDE de ejemplo corre. +4. **H-kwin**: `kwin_wayland` levanta como compositor y pinta un fondo. +5. **H-shell**: `plasmashell` arranca sobre `kwin`, con panel y lanzador. **← "escritorio prende".** +6. **H-sesión**: login (SDD/mirada) → sesión Plasma completa, con audio (PipeWire), red (plasma-nm), + `konsole` + `dolphin` corriendo. **← distro gráfica booteable-usable.** + +## Estrategia de granja + +- La granja **efímera** ([[granja-efimera-hcloud]]) es la herramienta de volumen: `farm-run N`. +- **PERO**: el escritorio no es "importar 700 y `farm-run`". El build-yield de C++/CMake/Qt es bajo; + cada receta pide de-Alpinización manual, patches y orden estricto. La granja **muele lo que ya está + bien importado**; el cuello es producir recetas de calidad, denso y asistido. +- **Aislamiento de cola**: el otro agente comparte `recipes/incoming/` (stack tawasuyu). Esta campaña + usa cola propia **`recipes/incoming-kde/`** y commits con rutas explícitas (nunca `git add -A`), + mismo patrón que `incoming-go` ([[etapa-g-frente-go]]). +- **No rebuildear en el laptop** el stack que el worker selle (zig-skew, [[etapa-g-gui-chain-boundary]]). +- Cadencia por capa: importar+pinnear una capa → `farm-run` → cosechar+firmar → subir a la siguiente. + No fan-out ciego entre capas (violaría el orden topológico). +- `qtwebengine` (Chromium) se **difiere**: es la receta más cara del proyecto y no es necesaria para + H-shell. Se ataca sólo si una app núcleo lo exige. + +## Riesgos y deudas conocidas + +- **musl vs. Qt/KDE**: partes pueden exigir glibc-ismos. Mitigación: aislar + documentar deuda, no + glibc global. +- **zig-cc en C++ a escala**: puede haber caídas masivas a gcc-gueto. Aceptado; se documenta por comp. +- **Vulkan/GL soberano**: KWin quiere aceleración; hoy arrastramos "deuda GL de Alpine". Puede forzar + atacar Mesa/driver a fondo antes de H-kwin. +- **Tamaño**: install de escritorio KDE ronda miles de paquetes contando cierre transitivo; esta es + una **campaña larga**, no una tanda. Los ~700 son las recetas *nombradas*; el árbol es mayor. +- **Reproducibilidad**: el régimen dinámico + plugins dlopen complica el hashing determinista que dio + 748 reproducibles. Hay que extender la disciplina de sellado a `.so` con SONAME estable. + +## Alternativas consideradas + +- **XFCE/GNOME primero** (más baratos): descartado por decisión de producto — KDE fija el techo. +- **Mantener todo estático**: inviable, Qt/Plasma requiere dlopen de plugins. +- **Adoptar binarios Qt/KDE de Alpine sin rebuild**: viola soberanía del bootstrap; se acepta sólo + como deuda puntual (ej. GL), no como base del escritorio. + +## Próximo paso concreto + +Importar+pinnear la **Capa 0 faltante** a `recipes/incoming-kde/` (empezando por Mesa-completo + +pila xcb/X11 + elogind/seatd + PipeWire), y correr la primera `farm-run` de la campaña. El gate +temprano a perseguir es **H-Qt**: si `qtbase` + una ventana Qt no funciona bajo el régimen dinámico, +todo lo demás se replantea antes de gastar granja en 700 recetas. diff --git a/recipes/incoming-kde/.gitkeep b/recipes/incoming-kde/.gitkeep new file mode 100644 index 00000000..e69de29b