sergio/takana

1# protobuf 36.1 — **`protoc`**, el compilador de `.proto`. Es el hueco que se ve solo al mirar el
2# catálogo: `recipes/protoc-gen-go.toml` está SELLADO y es **inerte**, porque un plugin de protoc no
3# hace nada sin protoc; y cualquier servicio gRPC necesita `protoc` en tiempo de build — empezando
4# por `qdrant`, que el censo del servidor de origen encontró corriendo como binario suelto (de los
5# que se pierden al apagar la máquina vieja) y cuyo `build.rs` lo invoca vía prost/tonic.
6#
7# **La dep de abseil no se vendoriza ni se descarga: se declara.** El tarball de release de protobuf
8# NO trae abseil adentro (comprobado: cero entradas bajo `third_party/abseil-cpp/`), y su
9# `cmake/abseil-cpp.cmake` tiene un fallback que hace `FetchContent` desde GitHub. Ese fallback en
10# este lab es una trampa doble: el sandbox está OFFLINE, así que fallaría igual — pero fallaría
11# hablando de red y no de dependencias — y si algún día no estuviera offline, metería una fuente sin
12# pinear en un build que se supone reproducible. `protobuf_LOCAL_DEPENDENCIES_ONLY=ON` apaga el
13# fallback ⇒ si abseil no está, el error dice *«Cannot find abseil-cpp dependency»*, que es lo que
14# uno necesita leer. `recipes/abseil-cpp.toml` está pineada a la versión exacta que este protobuf
15# declara.
16#
17# `-Dprotobuf_BUILD_TESTS=OFF`: la suite arrastra googletest, que es otra dep que no hace falta para
18# producir un `protoc`. `-Dprotobuf_BUILD_SHARED_LIBS=OFF` deja `protoc` monolítico salvo por la libc.
19#
20# ⚠ **`compiler = "zig-cc"` Y `-static-libstdc++`: DOS MUROS, Y EL SEGUNDO ESCONDÍA AL PRIMERO.**
21#
22# 1. **`zig c++` SE CAE AL ENLAZAR los tres plugins `protoc-gen-upb*`** — `Error running link
23#    command: Segmentation fault`, no un error de símbolos. Se aisló FUERA de takana y fuera del
24#    sandbox: rehaciendo a mano el link de `protoc-gen-upb` con el `zig` del lab, sobre los mismos
25#    `.o` y las mismas `.a`, `zig c++` vuelve a segfaultear. No es presión de memoria (corrió solo) y
26#    no es el `-Wl,-rpath,::::::::::::::` que CMake emite —se probó sin él y cae igual—. Con `g++` y
27#    el `ld` de GNU los cuatro binarios enlazan. `protobuf_BUILD_LIBUPB=OFF` **no** es escapatoria:
28#    se probó, queda `OFF` en el `CMakeCache` y los plugins se construyen igual.
29#
30# 2. **abseil y protobuf TIENEN QUE COMPARTIR RUNTIME DE C++.** Al pasar sólo protobuf a `gcc`, con
31#    abseil todavía construida por `zig-cc`, el link murió con
32#    `undefined reference to std::__1::basic_string<…>::assign(char const*, unsigned long)`. El `__1`
33#    es el namespace inline de **libc++** (la que trae zig); g++ usa **libstdc++ de GNU**, con otro
34#    mangling para los mismos tipos. El error habla de `std::string` y no nombra a abseil ni una vez.
35#    Por eso `recipes/abseil-cpp.toml` también lleva `compiler = "gcc"`, y **cambiar una sin la otra
36#    vuelve a romper**.
37#
38# ⚠⚠ **ACTUALIZACIÓN 2026-09-12: LA CAUSA ERA OTRA, Y LA RECETA VOLVIÓ A `zig-cc`.** Lo de arriba
39# describe lo que se midió el día 11 y sigue siendo cierto como SÍNTOMA, pero el diagnóstico se
40# quedó corto: el crash no es «zig no puede con estos plugins». Apareció otra vez en `dwarves` y ahí
41# se bisecó la línea de enlace real (`build/CMakeFiles/<target>.dir/link.txt`, rehecha a mano fuera
42# del sandbox):
43#
44#     tal cual                      → exit 139 (SIGSEGV)
45#     quitando `-static`            → exit 139     ⇒ no es el enlace estático
46#     quitando `--dependency-file`  → **exit 0**   ⇒ ES ESO
47#
48# `-Xlinker --dependency-file=…` lo emite CMake ≥3.27 y el `lld` de zig 0.16.0 segfaultea
49# procesándolo. Con `-DCMAKE_LINK_DEPENDS_USE_LINKER=OFF` los cuatro binarios enlazan con zig, así
50# que **el escape a gcc sobra** — y con él se va también el `-static-libstdc++`, que sólo hacía falta
51# porque g++ enlaza contra la libstdc++ de GNU. abseil vuelve a `zig-cc` en el mismo movimiento: el
52# runtime de C++ de las dos tiene que coincidir, y eso no cambió.
53#
54# Se deja escrito el camino entero, con el diagnóstico corto incluido, porque la lección no es la
55# perilla: es que **esquivar un fallo sin conocer su causa funciona y cuesta caro después** — dos
56# recetas fuera del toolchain por defecto y un choque de runtimes de C++ que apareció sólo porque el
57# escape era parcial.
58#
59# **Ya NO hace falta `-static-libstdc++`**: lo llevaba mientras la receta iba con `g++`, que enlaza
60# contra la libstdc++ de GNU y habría dejado a `protoc` pidiendo `libstdc++.so.6`, una soname que
61# sólo vive en el LAB ([[needed-colgante-libstdcxx]]). Con `zig-cc` la libc++ va estática de fábrica.
62# Comprobado sobre el artefacto: el único NEEDED de `protoc` es `libc.so`, que provee `musl-shared`.
63#
64# Lo que sale, verificado corriéndolo y no por el código de salida: `protoc` (13,3 M) más los tres
65# plugins de upb, y un `.proto` de prueba se compila a `.pb.h`/`.pb.cc` de verdad.
66#
67# `CMAKE_INSTALL_LIBDIR=lib` por lo de siempre: el lab usa `/usr/lib`, no `/usr/lib64`, o los `.pc` y
68# los `.cmake` quedan donde ningún consumidor los busca.
69#
70# ⚠ **La versión de protobuf ES contrato de generación, no sólo de API.** `protoc` decide qué código
71# emite, y el `.pb.cc`/`.pb.go` generado tiene que casar con la librería runtime que el consumidor
72# enlace. Subirla no es actualizar una herramienta: es mover el formato de lo que sale.
73name    = "protobuf"
74version = "36.1"
75license = "BSD-3-Clause"
76
77[source]
78tarball = "https://github.com/protocolbuffers/protobuf/releases/download/v36.1/protobuf-36.1.tar.gz"
79sha256  = "dc74fa582f559cbd31614ddfefb4868f43c919d7184bde514bb47f90c6025eb8"
80
81[build]
82compiler = "zig-cc"
83target   = "x86_64-linux-musl"
84link     = "dynamic"
85flags    = []
86
87[build.phases]
88configure = "cmake -S . -B build -DCMAKE_LINK_DEPENDS_USE_LINKER=OFF -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_INSTALL_LIBDIR=lib -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_STANDARD=17 -DBUILD_SHARED_LIBS=OFF -DCMAKE_POSITION_INDEPENDENT_CODE=ON -Dprotobuf_BUILD_TESTS=OFF -Dprotobuf_BUILD_SHARED_LIBS=OFF -Dprotobuf_LOCAL_DEPENDENCIES_ONLY=ON -Dprotobuf_ABSL_PROVIDER=package"
89compile   = 'cmake --build build -j"$(nproc)"'
90install   = "DESTDIR=/out cmake --install build"
91
92[deps]
93build = ["binutils", "busybox", "make", "cmake", "abseil-cpp", "zlib"]