sergio/takana

1# portal-probe — la SONDA del portal XDG. La única receta de la campaña cuyo producto no es una
2# pieza del escritorio sino un INSTRUMENTO para medirlo.
3#
4# ── QUÉ MIDE, Y POR QUÉ NINGUNA HERRAMIENTA EXISTENTE SIRVE ─────────────────────────────────────
5# Los portales no son RPC: son un protocolo asíncrono en dos tiempos. Cada método devuelve al
6# instante un object path de `Request`, y el resultado de verdad llega DESPUÉS como señal
7# `org.freedesktop.portal.Request.Response` sobre ese path. `dbus-send` ya salió para entonces ⇒
8# devuelve el path y nunca el resultado. Eso es lo que impidió capturar la URI del `FileChooser`.
9#
10# Y hay un segundo muro, más duro: **el portal ata la sesión al SENDER**. `CreateSession` con un
11# `dbus-send` y `SelectSources` con otro llegan desde nombres únicos DISTINTOS y el portal rechaza
12# el segundo. No hay forma de encadenar el handshake desde el shell; hace falta UNA conexión que
13# viva todo el intercambio. Por eso esto es un binario y no un script.
14#
15# ── POR QUÉ EN C Y NO CON `ashpd` ───────────────────────────────────────────────────────────────
16# `ashpd` es el cliente de portales del ecosistema Rust —es lo que usan `cosmic-screenshot` y
17# `cosmic-files`— y era el camino obvio. Pero el árbol fuente de esta receta es el repo del PROPIO
18# takana (no hay modo `path` en `[source]`: sólo git y tarball), así que usar ashpd significaría
19# sumar ~150 crates al `Cargo.lock` de la herramienta de build por una sonda de diagnóstico.
20#
21# `libdbus` ya está en el corpus, cuesta cero deps nuevas, y `dbus` provee `libdbus-1.a` ⇒ la sonda
22# sale **estática, sin un solo NEEDED**, que es justo lo que uno quiere de un instrumento: que no
23# dependa de nada de aquello que va a medir. Y sobre todo: en C el protocolo SE VE. Una sonda cuyo
24# valor es documentar un handshake no debería esconderlo tras una biblioteca que lo abstrae.
25#
26# ── EL VENDOREO QUE SE PAGA IGUAL ───────────────────────────────────────────────────────────────
27# El árbol fuente es el repo takana entero, cuya raíz tiene `Cargo.toml` ⇒ `detect_build_system`
28# dice Cargo y el fetch vendorea el workspace. No se puede apagar (`cargo_vendor` sólo FUERZA, no
29# desactiva). Es un costo de tiempo en el fetch, no de corrección: la fase `compile` de acá abajo
30# ignora cargo por completo y llama a `zig cc` sobre un único `.c`. Mismo peaje que paga `hammerd`.
31name    = "portal-probe"
32version = "0.1.0"
33license = "MIT"
34
35[source]
36# El repo del propio takana. El `commit` es el identificador inmutable (la URL es sólo locator y no
37# entra al hash). Subir el commit cuando la sonda avance — y sólo entonces: fijar el commit es lo
38# que hace que un instrumento de medición sea él mismo reproducible.
39repo   = "ssh://gitea@git.gioser.net:2345/sergio/hammer.git"
40commit = "a5c959b6186acef13260cf6b42aa1cbfc1d56f34"
41
42[build]
43compiler = "zig-cc"
44target   = "x86_64-linux-musl"
45# Estático de verdad, y acá SÍ es la decisión correcta en vez de la coherencia con la suite: el
46# resto de los clientes van dinámicos porque `wayland-client` hace `dlopen` (ver el runbook). Esta
47# sonda no toca wayland, y un instrumento que arrastra NEEDED puede fallar por una razón que no es
48# la que está midiendo.
49link     = "static"
50
51[build.phases]
52# Sin configure: es un fichero.
53configure = "true"
54
55# `zig cc` directo. Los flags de dbus salen de su `.pc`, que vive en el artefacto del store y el
56# sandbox proyecta en /usr — de ahí el PKG_CONFIG_PATH. Los dos `-I` de dbus son SIEMPRE dos y no
57# uno: `dbus-arch-deps.h` es generado y vive bajo `lib/dbus-1.0/include`, no junto al resto de los
58# headers. Un `-I` solo compila hasta que algo incluye `dbus.h` de verdad.
59#
60# ⚠ EL `-L/usr/lib` HAY QUE PONERLO A MANO, y el motivo es un choque de supuestos entre dos
61# herramientas: **pkg-config OMITE los `-L` de directorios que considera estándar del sistema**
62# (`/usr/lib` lo es), asumiendo que el linker ya los busca. Cierto para un `cc` nativo; FALSO para
63# `zig cc` cruzando a `x86_64-linux-musl`, que trae sus propias rutas y no da nada por sentado.
64# Resultado: `--libs --static` devuelve `-ldbus-1` pelado y zig responde
65# `unable to find static system library 'dbus-1' … searched paths: none` — un error que suena a
66# «falta la librería» cuando la librería está ahí y lo que falta es la ruta.
67compile = '''
68export PKG_CONFIG_PATH=/usr/lib/pkgconfig:/usr/share/pkgconfig
69CF=$(pkg-config --cflags dbus-1)
70LF=$(pkg-config --libs --static dbus-1)
71echo "cflags: $CF"
72echo "libs  : $LF"
73zig cc -target x86_64-linux-musl -static -O2 -Wall -Wextra \
74  -o portal-probe tools/portal-probe/portal-probe.c $CF -L/usr/lib $LF
75'''
76
77install = '''
78mkdir -p /out/usr/bin
79cp portal-probe /out/usr/bin/portal-probe
80chmod 755 /out/usr/bin/portal-probe
81'''
82
83[deps]
84# `dbus` por la librería y los headers; `pkgconf` para que el `.pc` se pueda leer. Nada más: la
85# sonda no dibuja, no abre ventana y no habla wayland — igual que `cosmic-screenshot`, que también
86# es un cliente puro de portal.
87build = ["dbus", "pkgconf"]