1# SDD 28 — El servidor de producción: instalar takana puro en una caja remota y mudarse a ella
2
3Escrito 2026-09-09 a pedido del usuario («qué tan lejos estamos de montar un server takana en
4Hetzner y que sea producción, y mover allá todo lo que tengo acá, y de una vez mantenerlo por repo
5takana»). Todo número marcado *(medido)* salió de un comando corrido ese día sobre `gioser`.
6
7Continúa [SDD 19](19-lanzamiento-publico.md) (lanzamiento público) y
8[SDD 27](27-perfiles-instalables-y-el-instalador.md) (metapaquetes e instalador). **No repite el
9instalador**: SDD 27 decide QUÉ se instala y con qué verbo; esto decide DÓNDE, y cómo se llega.
10
11---
12
13## 0. La corrección de encuadre: ya estamos en Hetzner
14
15`gioser` **es** un servidor Hetzner (hcloud id `126324694`, hel1, 4 cores / 7,6 GiB) *(medido)*. La
16pregunta no era «cómo llegar a Hetzner» sino **cómo tener una caja de takana** en vez de ser un
17inquilino más de una máquina compartida que:
18
19- sirve **19 dominios** por Caddy,
20- tiene `/mnt/vvv` al **89 %** (27 G libres) *(medido)*,
21- es **fija y sin backup** por pedido explícito del usuario (blindaje anti-borrado en `deadman.sh` y
22  `farm-down.sh`, ver [ADR 0014](adr/0014-distribucion-multiorigen.md) y la memoria del proyecto),
23- y **no publica nada de takana**: cero entradas de takana en el Caddyfile *(medido)*.
24
25### 0.1 El hallazgo que cambia el tamaño del problema
26
27```
28$ ps -p 1 -o comm=,args=
29arje-zero  /usr/local/sbin/arje-zero
30$ cat /proc/cmdline
31BOOT_IMAGE=/vmlinuz-linux root=UUID=54de62df-… rw net.ifnames=0 splash \
32  init=/usr/local/sbin/arje-zero loglevel=4
33```
34
35**El init de takana ya gobierna un servidor de producción real.** Caddy, gitea, sshd, qdrant y
36act-runner cuelgan directo de PID 1 *(medido: `ps -eo pid,ppid,comm | awk '$2==1'`)*.
37
38Pero **eso no es takana puro**: es Artix con nuestro init inyectado por `init=` en el cmdline. El
39kernel, la libc y los 19 servicios son ajenos. Se probó la mitad difícil sobre userland prestado.
40
41### 0.2 ⚠ La declaración del arranque no existe en ningún sitio legible
42
43`rc-status` de OpenRC dice `stopped` para **caddy, gitea, sshd, cronie y act-runner**, y los cinco
44están **vivos** *(medido, los dos comandos)*. `/etc/arje/cards.d` tiene **4 tarjetas** (`acpid`,
45`openrc-openclaw`, `squid`, `zram-swap`) y ninguna de ellas los levanta.
46
47⇒ **La secuencia de arranque de esta caja no está escrita.** Es lo menos reproducible de toda la
48mudanza y lo primero que hay que capturar — ver §4.
49
50---
51
52## 1. Inventario de lo que hay que mudar *(medido 2026-09-09)*
53
54### Datos en `/mnt/vvv` (217 G de 255)
55
56| | |
57|---|---|
58| `tawasuyu` | **124 G** |
59| `takana` | **91 G** — incluye el store de 55 G bind-mounteado desde el otro volumen ⇒ ~36 G propios |
60| `rustup` | 29 G |
61| `act-runner` · `gioserv` · `_respaldo` | 6,5 · 5,4 · 4,1 G |
62| ~20 dirs `*-standalone` | agora, card, chasqui, cosmos, dominium, khipu, minga, mirada, nakui, nahual, pata, pineal, pluma, shuma, takiy, llimphi… |
63
64### El volumen `harkaq-cosecha` (250 G, 148 G usados)
65
66| | |
67|---|---|
68| `store` | **55 G**, **1327 artefactos** — lo irreemplazable |
69| `work-sources` + `cargo-home` + `gopath` | ~85 G — **caché regenerable**, no se muda |
70| `work-tarballs` · `devfs-cache` · `work-out` | 3,2 G · 4,5 G · 397 M |
71
72**El store no se copia por red.** Los dos volúmenes están en `hel1`; un volumen hcloud se desengancha
73de una caja y se engancha a otra en la misma ubicación. La mudanza del store son dos comandos.
74
75### Servicios vivos, todos hijos de arje-zero
76
77`caddy` :80/:443 · `gitea` :3002 · `sshd` :2345 · `act_runner` (el CI de tawasuyu) · `qdrant`
78:6333/:6334 · `openclaw` · `zeroclaw` · `shuma-gateway` :7378 · `tejido` :4102 y :33097 ·
79`puerta-f6e393ff` · `uvicorn` :8771 · `python3` :8770 · `squid` :1137 · `fail2ban` · `glances` ·
80`php-fpm` · `metalog` · **`adb` :5037**.
81
82### Lo que no está en ningún repo
83
84`/var/lib/gitea` (**2,2 G**: SQLite + los repos de git de todo, **incluido el `origin` de takana**) ·
85`/var/www` (287 M) · `/home/sergio/gioser-web/` · `/etc/caddy/Caddyfile` **+ 20 ficheros `.bak`** ·
86los certificados de letsencrypt · los crontabs · `/etc/arje/cards.d` · las 3 credenciales de
87`~/.config/hammer/*.env` · las llaves `~/.ssh/{github5,sergio}` · el token hcloud · y **la memoria
88del agente en `~/.claude/`**.
89
90### 1.1 La basura, contada — porque una mudanza fiel copia también la basura
91
92De los 19 dominios del Caddyfile *(probados uno por uno desde la propia caja)*:
93
94| responden 200 | rotos |
95|---|---|
96| gioser.net · tawasuyu.net · git.gioser.net · summa.gioser.net · sergio.gioser.net | **api.gioser.net → 502** (backend caído) |
97| | **aura · sigma · kosmofono · terapeuta.ec → sin DNS** |
98
99Y sus raíces **no existen en disco**: `/var/www` sólo tiene `terapeuta`, `goaccess`, `ogisoer`,
100`git-tawasuyu`, `letsencrypt` y un `.bak` — no hay `aura_frontend`, ni `sigma`, ni `summa/frontend`,
101ni `kosmofono`. **La mitad del Caddyfile describe un servidor que ya no existe.**
102
103⇒ **Regla de la mudanza: no se muda lo que no responde.** Lo que no tiene DNS ni ficheros se anota y
104se deja morir con la caja vieja. La utilidad del §4 tiene que saber decir *declarado / vivo / fósil*.
105
106---
107
108## 2. La caja: qué, cuánto y por qué
109
110Precios consultados a la API de hcloud el 2026-09-09 (hel1, x86, tipos no deprecados) *(medido)*:
111
112| tipo | recursos | €/mes |
113|---|---|---:|
114| **`cx53`** | **16 c / 32 G / 320 G** | **29,49** |
115| `cpx41` | 8 c / 16 G / 240 G | 32,49 |
116| `ccx23` (dedicado) | 4 c / 16 G / 160 G | 85,99 |
117
118**Elegido `cx53`**: es el mejor punto de la tabla y entra holgado el conjunto tawasuyu + takana +
119rustup (~244 G) si algún día se muda todo.
120
121**Decisiones del usuario (2026-09-09):**
122
1231. **La caja PUBLICA; el LXC prestado sigue moliendo.** `dev.gioser.net` cuesta €0 y es la máquina
124   con más RAM (6 c / 16 G + 8 G swap). Separar *servir* de *compilar* mantiene la caja chica y
125   barata. La caja nueva puede además compilar, con el LXC enchufado como segundo worker.
1262. **«Producción» = operativo pero privado.** Sin descarga pública todavía ⇒ **no** se activan los
127   bloqueantes legales del [SDD 19 §2](19-lanzamiento-publico.md) (espejo de fuentes público por
128   HTTP, marca de terceros). Lo que sí hace falta igual es la **clave de release estable** (§5).
1293. **gioser se BORRA** cuando la mudanza esté comprobada. Eso convierte esto en un experimento con
130   fecha de caducidad, y cambia el diseño entero: ver §6.
131
132⚠ **El blindaje anti-borrado de gioser es deliberado y hay que levantarlo a mano y a propósito.**
133`deadman.sh` y `farm-down.sh` lo protegen por lista negra de nombre **y** por ausencia del label
134`role=hammer-worker`. Ninguna automatización debe poder borrarlo: cuando llegue el día, se borra a
135mano, con la comprobación del §6 en verde y no antes.
136
137---
138
139## 3. Instalar takana puro en una caja remota
140
141### 3.1 Lo que ya está, y por qué está más cerca de lo que parece
142
143**El dato que lo destraba: Hetzner Cloud arranca por BIOS, no por EFI.** *(medido en gioser: no
144existe `/sys/firmware/efi`; GPT + GRUB; `/boot` es vfat de 1 G.)* Y `scripts/takana-install.sh`
145escribe **exactamente ese layout**: GPT + GRUB BIOS, `SeaBIOS → GRUB → kernel → arje-zero PID1`.
146El camino EFI —que fue el que más trabajo costó ([ADR 0010](adr/0010-arranque-grafo-mirada.md))— es
147el que Hetzner **no** necesita.
148
149| pieza | estado *(medido)* |
150|---|---|
151| kernel con virtio | `recipes/linux.toml` compila `VIRTIO`, `VIRTIO_PCI`, `VIRTIO_BLK`, `VIRTIO_NET`, `EXT4_FS` **`=y`** ⇒ sin initramfs |
152| red | `crates/netup` = cliente **DHCPv4 propio** en Rust sobre netlink, autodetecta interfaz y espera carrier. gioser toma su IP por **DHCP en `eth0`** (`/32`, `net.ifnames=0`, DNS `185.12.64.2`) ⇒ es justo su caso |
153| acceso | `recipes/openssh.toml` sellado; el `product-rootfs` vigente **ya trae `sshd`**; `takana-install.sh` acepta `AUTHKEYS` |
154| servir | `recipes/caddy.toml` existe |
155| escritura a disco | `scripts/takana-install.sh` (no interactivo) y `scripts/takana-live-install.sh` (TUI), probado por `scripts/install-tui-test.sh` |
156
157### 3.2 El camino remoto: rescue → `dd` → reboot
158
159Hetzner Cloud tiene un **sistema de rescate** (Debian por SSH) que se activa desde la API sin tocar
160la caja. Desde ahí se escribe la imagen al disco y se reinicia. **No hace falta ISO, ni consola, ni
161medio físico** — que es justo lo que hace innecesario el 90 % del trabajo de ISO/USB para este caso.
162
163### 3.3 Los cuatro huecos, nombrados
164
1651. **`perfil.servidor`** — **HECHO hoy** en `docs/state/targets.toml`. Ver §3.4.
1662. **`console=ttyS0` en el cmdline** — el único salvavidas si el arranque falla y no hay teclado.
167   Hetzner da consola web; sin serial en el kernel, esa consola no muestra nada útil.
1683. **IPv6** — `netup` hace DHCPv4 y Hetzner entrega un `/64` **estático**. La caja arrancaría con
169   IPv4 sola. Aceptable para empezar, pero hay que saberlo **antes**, no descubrirlo.
1704. **Un `.img` del perfil servidor** que el rescue pueda escribir. Es `hydrate-profile.py` +
171   `install-image.sh`, los dos ya existentes — ver §7.
172
173### 3.4 El perfil, y la deuda que declara *(hecho 2026-09-09)*
174
175`[perfil.servidor]` hereda `cli` (que hereda `base`, [SDD 27 §7.1](27-perfiles-instalables-y-el-instalador.md))
176y añade **5 raíces que existen** (`openssh`, `caddy`, `curl`, `wget`, `tmux`) y **5 que NO**:
177
178| raíz que no resuelve | por qué está declarada igual |
179|---|---|
180| **`takana`** | **el propio takana no tiene receta.** El corpus construye 869 recetas y no la suya ⇒ el binario sólo existe como `cargo build` sobre un clon. Es EL bloqueante del §5 |
181| `chrony` | sin NTP, un reloj que deriva rompe TLS y las firmas — y falla diciendo «firma inválida», no «la hora» |
182| `nftables` | `dev.gioser.net` está hoy expuesto con fuerza bruta a root en el journal; una caja nueva no debería nacer así |
183| `cronie` | el latido son tres líneas de crontab, y sin systemd no hay timers: o hay cron, o el latido es una tarjeta de arje-zero. **Decisión pendiente** |
184| `logrotate` | en una caja que sirve, el log de acceso crece hasta llenar el disco |
185
186Quedan **`wanted`** en el grafo, y **`wanted` no es `debt`** ⇒ `drenaje.json` seguirá diciendo
187`deuda=0`. Se declaran igual porque **una deuda escrita se ve y una omitida no**: sin ellas el perfil
188saldría N/N —completo y verde— describiendo un servidor sin hora, sin cortafuegos y sin latido. Es
189la lección de `foot` en `escritorio-sway` (121/121 sellado y sin emulador de terminal), pagada por
190adelantado. **Cuenta esperada: 5.** Un sexto `wanted` es un error de tipeo, no una receta nueva.
191
192### 3.5 La caja, creada *(2026-09-10)*
193
194| | |
195|---|---|
196| nombre / id | `takana` / `165447050` |
197| tipo | **`cx33`** — 4 c / 7,6 GiB / 76,3 G — **€8,49/mes** |
198| ubicación | **hel1** — la misma que los volúmenes `vvv` y `harkaq-cosecha` y que el Storage Box |
199| IPv4 / IPv6 | `2.29.29.217` · `2a01:4f9:c014:2f9c::/64` |
200| imagen inicial | `debian-13` — **desechable**: existe sólo para recibir ficheros hasta el `dd` del §3.2 |
201| label | `role=takana-server` |
202| protección de borrado | **NO**, a propósito: es la caja de sacrificio |
203
204⚠ **El label importa**: `farm-down.sh` y `deadman.sh` borran **sólo** lo que lleva
205`role=hammer-worker`. Esta caja no lo tiene ⇒ ninguna automatización de la granja puede tocarla.
206Es la misma capa fuerte que protege a gioser, aplicada al revés: no se protege por nombre, se
207protege por no haber nacido de `farm-up`.
208
209⚠ **`cx53` no se pudo comprar: sale `Available: no` en las TRES ubicaciones.** Y la disponibilidad
210**cambia por día** — `cx33` salió `no` en hel1 el 2026-09-09 y `yes` el 2026-09-10, con la misma
211consulta. ⇒ **el precio de la tabla no dice que la máquina exista**: `hcloud server-type list`
212devuelve precios para tipos que no se pueden crear. Consultar `Available` por ubicación, y volver a
213consultarlo el día que se compra.
214
215#### Lo que la caja confirma, medido EN ELLA y no inferido de gioser
216
2171. **Arranca por BIOS** — no existe `/sys/firmware/efi`… **y sin embargo la imagen trae un ESP**
218   (`sda15`, 244 M vfat en `/boot/efi`). O sea: **la presencia de una partición EFI no indica
219   arranque EFI**. Si el instalador decidiera la rama mirando particiones en vez de
220   `/sys/firmware/efi`, elegiría mal en esta caja exacta. `takana-live-install.sh` mira lo correcto.
2212. **`console=tty1 console=ttyS0` viene en el cmdline de Debian.** Confirma que el serial es lo que
222   Hetzner espera, y que el hueco 2 del §3.3 es real: nuestra imagen tiene que traerlo o la consola
223   web no muestra nada.
2243. **`eth0` con `/32` dinámico por DHCP** — idéntico a gioser ⇒ es exactamente el caso de `netup`.
225
226#### Dos cosas pendientes en la caja, anotadas
227
228- **7,6 GiB de RAM y CERO swap** — la misma clase de máquina que ya provocó `global_oom` en gioser.
229  Coherente con la decisión de §2.1 (la caja **publica**, el LXC muele), pero significa que **no se
230  construye pesado acá** mientras siga así.
231- **`sshd` trae `PasswordAuthentication yes`** (con `PermitRootLogin without-password`, así que root
232  por clave igual). El journal del LXC muestra fuerza bruta a root desde IPs random; esta caja está
233  igual de expuesta. Se cierra cuando se instale takana puro, o antes si se queda días con Debian.
234
235### 3.6 La imagen del `perfil.servidor`, armada y validada *(2026-09-10)*
236
237**Receta del ensamblado** (todo con scripts que ya existían, §7):
238
239```sh
240# 1. base con init: el product-rootfs sellado (trae /sbin/init -> /usr/bin/arje-zero)
241cp -al /mnt/cosecha/store/5011955a…-product-rootfs/. $D/
242# 2. userland del perfil encima
243scripts/hydrate-profile.py servidor --into $D --store /mnt/cosecha/store --keep
244# 3. ⚠ restaurar el init (ver abajo) y meter la clave
245ln -sf /usr/bin/arje-zero $D/sbin/init ; cp github5.pub $D/root/.ssh/authorized_keys
246# 4. imagen
247ROOTFS=$D STAGE=/mnt/cosecha/.install-stage KERNEL=store/23f1cc43…-linux-generic/boot/bzImage \
248CMDLINE="console=ttyS0,115200 console=tty0 root=/dev/sda2 rw init=/usr/bin/arje-zero" \
249  ./scripts/install-image.sh
250```
251
252Resultado: **86 nodos, 30.500 ficheros, 2,0 G de rootfs → imagen de 7.172 M (2,1 G en disco, sparse)**.
253
254#### El kernel correcto es `linux-generic`, y `linux.toml` NO sirve para hcloud
255
256El disco de una caja hcloud lo maneja **`virtio_scsi`** (driver `sd`, disco `sda`) — no `virtio_blk`.
257`recipes/linux.toml` **apaga SCSI explícitamente** (`-d SCSI`) ⇒ su kernel arranca y **no ve el
258disco**. `linux-generic`, `linux-metal` y `linux-metal-dual` sí sirven.
259
260⚠ **Y ninguna receta nombra `SCSI_VIRTIO`.** Está encendido igual, porque `make defconfig` lo trae y
261`-e SCSI -e BLK_DEV_SD` lo mantiene. Se supo mirando el `.config` que `linux-generic` **publica en su
262artefacto** (`/boot/config-7.1.2-generic`), no leyendo la receta. La receta dice lo que se cambió;
263sólo el `.config` sellado dice lo que quedó.
264
265#### ⚠ La hidratación PISA `/sbin/init`, y el resultado arranca igual
266
267`busybox` entra en la clausura del perfil y su `/sbin/init -> ../bin/busybox` **gana por llegar
268después**, borrando el `-> /usr/bin/arje-zero` del product-rootfs. La imagen habría arrancado
269perfecta **con el init de busybox**: no takana puro, y sin un solo error. Se tapa por las dos puntas
270— restaurando el symlink al ensamblar **y** con `init=/usr/bin/arje-zero` explícito en el cmdline,
271que es lo que hace gioser y es autoritativo pase lo que pase con el symlink.
272
273**Y la guarda que existía para esto estaba INVERTIDA** (arreglada en el mismo commit): `[ -e
274"$ROOTFS/sbin/init" ]` sigue el symlink y lo resuelve contra el *host*, así que el symlink ABSOLUTO
275a arje-zero daba falso y **el rootfs correcto era rechazado**, mientras que el relativo a busybox
276—el equivocado— pasaba. Ver [[guardian-que-nunca-fallo]]: una guarda que nunca falló no se sabe si
277sirve; ésta fallaba al revés.
278
279#### EXDEV, dos veces en la misma tarde
280
281`store` y `work/out` son bind-mounts de `/dev/sdb`; `work/` está en `/dev/sdc`. Un hardlink no cruza
282un montaje **aunque sea el mismo disco**, así que reventaron (1) `hydrate-profile.py` con el destino
283fuera del montaje del store —que avisa RUIDOSO y bien— y (2) el staging de `install-image.sh`, que
284lo tenía cableado a `work/`. Ahora `STAGE` es env. Ver [[hardlink-cruza-mount-exdev]].
285
286#### La validación: arrancó en QEMU reproduciendo virtio-scsi, y se entró por SSH
287
288```
289SeaBIOS → GRUB → kernel 7.1.2 propio → EXT4-fs (sda2): mounted → Pivoted into new rootfs
290→ Run /usr/bin/arje-zero as init process → "arje-zero: despierta como PID 1"
291→ netup (DHCP) → ssh-keygen -A → sshd
292```
293
294Y desde fuera: `ssh -p 2299 root@127.0.0.1` **entra**, `/proc/1/comm` dice `arje-zero`, `ip addr` da
295la IP que negoció `netup`. Es la puerta 1 del §6 ensayada en local antes de gastar la caja.
296
297El card `sshd` de `/ente/seed.card.json` ya hacía el trabajo entero sin que hubiera que tocar nada:
298`sh -c "/usr/bin/netup; /usr/bin/ssh-keygen -A; exec /usr/sbin/sshd -D -e"` — red, claves de host y
299demonio en una línea. Lo único que hubo que inyectar fue `authorized_keys`.
300
301#### Un resto del renombre, encontrado por el arranque
302
303```
304arje-zero: hammer no corre, sin menú de arranque: No such file or directory (os error 2)
305```
306
307**`arje-zero` invoca el binario por el nombre VIEJO (`hammer`).** No es fatal —sigue arrancando— pero
308el menú de arranque por grafo del [ADR 0010](adr/0010-arranque-grafo-mirada.md) queda muerto. Y viene
309de tawasuyu, pineado por `commit` en `recipes/arje-zero.toml`, así que **no se arregla desde este
310repo**: hay que subirlo allá y re-pinear. Se suma a que la imagen tampoco trae `takana` (§3.4).
311
312### 3.7 ⚠ El muro real: la puerta de enlace de Hetzner está FUERA del prefijo
313
314La imagen validada en QEMU se escribió a la caja, arrancó… y **no se pudo entrar**. `hcloud` decía
315`running`, el puerto 22 cerrado, y desde fuera `Connection timed out` — el modo de fallo más caro de
316todos, porque no hay consola serie en hcloud para mirar.
317
318La causa, medida entrando al rescue de la propia caja:
319
320```
321inet 2.29.29.217/32 scope global eth0
322default via 172.31.1.1 dev eth0
323172.31.1.1 dev eth0 scope link      ← ESTA es la que faltaba
324```
325
326**La IPv4 viene con prefijo `/32` y la puerta (`172.31.1.1`) no pertenece a ninguna red conectada.**
327`netup` mandaba el default con `RTA_GATEWAY` y scope UNIVERSE y nada más, así que el kernel lo
328rechazaba con `ENETUNREACH`: la máquina se quedaba **con IP y sin salida**, contestando el DHCP y
329levantando sshd, sin nada visiblemente roto por dentro.
330
331**Control causal**, en un netns con una dummy y una `/32`:
332
333```
334ip route add default via 172.31.1.1 dev dummy0   ⇒ Error: Nexthop has invalid gateway.
335ip route add 172.31.1.1 dev dummy0 scope link    ⇒ ok
336ip route add default via 172.31.1.1 dev dummy0   ⇒ ACEPTADO
337```
338
339Arreglado con `add_onlink_host_route` (dst `/32`, scope LINK) antes del default.
340
341**Por qué no había aparecido nunca**: `netup` se validaba contra el DHCP de QEMU slirp, que entrega
342un `/24` con la puerta dentro de la subred. El escenario que rompe sólo existe en una nube de verdad.
343Es [[cache-congela-regresiones]] en su otra forma: no es que el test estuviera mal, es que el ÚNICO
344entorno donde se probaba no contenía el caso.
345
346**Y destapó un segundo problema de fondo**: el binario de `netup` venía dentro del `product-rootfs`,
347o sea **congelado en un artefacto sellado del bootstrap** ⇒ arreglar netup no llegaba a la imagen.
348Por eso `netup` pasa a ser **raíz de `perfil.servidor`**: así la hidratación lo proyecta encima y la
349imagen lleva el vigente. Verificado por sha256 (imagen `a23df20e…`, product-rootfs `a84b0a0d…`).
350
351### 3.8 ✅ Puerta 1, pasada *(2026-09-10)*
352
353```
354PID 1    : arje-zero          kernel : 7.1.2 (linux-generic propio)
355IP       : 2.29.29.217        rutas  : default via 172.31.1.1 + 172.31.1.1 scope link
356montajes : /dev/sda3 -> /store      /dev/sda4 -> /var/lib/hammer
357salida   : ping 1.1.1.1 0% pérdida · curl http://1.1.1.1 -> 301 · resolv.conf escrito por netup
358```
359
360**Una caja Hetzner Cloud corriendo takana puro**: nuestro kernel, nuestro init, nuestro cliente DHCP,
361nuestro sshd — sin una línea de Debian debajo. El camino entero es
362`scripts/servidor-image.sh` + rescue + `dd`, y la escritura de los 7,1 G comprimidos tarda **~17 s**
363(gioser y la caja están las dos en hel1).
364
365Lo que la caja **todavía no** tiene, y es el paso 2: `takana` (sin receta, §3.4), el store real (el
366volumen no se engancha hasta acá) y las otras cuatro raíces `wanted`.
367
368---
369
370## 4. La utilidad de migración: absorber lo VIVO, no lo declarado
371
372`arje-absorb` ya existe, está sellado (`recipes/arje-absorb.toml`) y su `--help` dice: lee
373`sysvinit | runit | dinit | openrc | auto` y **emite una Tarjeta Semilla** con cada servicio del init
374ajeno como hija de arje-zero. Tiene parsers para los cinco (`systemd.rs`, `openrc.rs`, `runit.rs`,
375`dinit.rs`, `sysvinit.rs`).
376
377**Pero lee la declaración, y en gioser la declaración miente** (§0.2). Un `arje-absorb --from openrc`
378sobre esta caja produciría una Semilla que **no levanta el servidor**, y lo haría en silencio: la
379Semilla sería sintácticamente perfecta.
380
381⇒ Lo que falta es un **segundo lector**: absorber del **proceso vivo** (`/proc`: `ppid==1`, `cmdline`,
382`cwd`, entorno, fds en LISTEN) y **reconciliar** ambas lecturas marcando dónde discrepan. Eso es lo
383que el usuario nombró como «lo aprendido de matilda» — absorber lo que hay, no lo que está escrito.
384
385La utilidad debe clasificar en tres, no en dos:
386
387| clase | criterio | qué se hace |
388|---|---|---|
389| **vivo** | proceso corriendo **y** declarado | se muda |
390| **declarado, muerto** | en la config, sin proceso ni ficheros (los 4 dominios sin DNS) | **fósil: se anota y se deja morir** |
391| **vivo, no declarado** | proceso con `ppid==1` que ningún init declara (caddy, gitea, sshd, act-runner) | **se escribe la tarjeta que faltaba** — es el trabajo real |
392
393**Se construye al final**, estrenándose con la migración gioser → caja nueva, con el caso del
394`rc-status` que miente como test de aceptación. Su especificación es el §1 de este documento.
395
396---
397
398## 5. Que el servidor sirva sus propios paquetes a su propio host
399
400Existe el camino entero: `scripts/build-repo.sh` (corpus → `.swm` firmados + índice),
401`takana install --repo` que **ya acepta lista HTTP multi-origen** y verifica cada paquete contra el
402`digest` del índice firmado ([ADR 0014](adr/0014-distribucion-multiorigen.md)), `takana upgrade` con
403rollback, y caddy para servir `dist/repo` con un `file_server`.
404
405Lo que falta **no es servir**, son dos cosas:
406
4071. **La clave.** `build-repo.sh` firma hoy con una **clave efímera** por defecto (`keygen release` si
408   no se le pasa `KEY=`) *(medido, línea 33)*. Sin clave estable, «firmado» no significa nada. Es el
409   [SDD 19 §3.2](19-lanzamiento-publico.md) y es requisito aunque el repo sea privado.
4102. **La receta de `takana`** (§3.4). El host necesita `takana` instalado para consumir los paquetes,
411   y hoy no puede instalarlo desde el repo porque takana no está en el repo.
412
413### 5.1 Hecho *(2026-09-10)*: clave estable, repo firmado, y la caja sirviéndolo
414
415- **`trust/`** — la clave PÚBLICA de release en el repo; la privada en `~/.config/takana/keys/`
416  (0600, fuera de git). `scripts/repo-perfil.sh` **aborta si no la encuentra** en vez de inventar una
417  efímera, y tras firmar **verifica** el índice contra `trust/`.
418- **88/88** paquetes del perfil `servidor` publicados con `expected_hash` anclado.
419- **La caja los sirve** con `caddy file-server` sobre `/srv/repo`.
420
421**El control de la firma, en los dos sentidos**, contra el repo servido por la caja:
422
423| `--trust` | resultado |
424|---|---|
425| `./trust` | `release: trusted (by release)` ⇒ instala |
426| un directorio vacío | `release: unknown-key … clave no confiada` ⇒ **ABORTA** |
427
428### 5.2 ⚠ Lo que el lazo destapó: `strip_debug` no viajaba en el paquete
429
430La primera instalación real de `takana` desde su propio repo falló:
431
432```
433Error: expected_hash no coincide:
434  declarado = b3:941d1857…   obtenido = b3:2727050e…
435```
436
437`why-differs` lo nombró: los dos binarios pesaban **exactamente lo mismo** y sólo divergían en
438`.shstrtab` — la firma de un `strip` que corrió una vez y la otra no. `swm_bridge` re-inyecta con
439cuidado `flags`, `phases`, `zig_version`, `strip_components`, `patches`, `deps`… y **se olvidaba de
440`strip_debug`**, que ni siquiera existía en `SwmBuild`. Como **entra en `hash_inputs`**, el receptor
441reconstruía en otra dirección.
442
443**Alcance: 40 recetas del corpus, 18 de las 88 de este perfil.** Una quinta parte del repo no se
444podía instalar, y nadie lo sabía porque **nunca se había cerrado el lazo**. Arreglado, con test de
445regresión y su control. Tras el arreglo, `install takana` da cache-hit en el hash anclado.
446
447### 5.3 ⚠ Y el loopback nunca se levantaba
448
449Al intentar que la caja instalara de sí misma por `http://127.0.0.1`: **timeout de 30 s**, con caddy
450escuchando en `0.0.0.0:80`. `lo` estaba **`DOWN` y sin dirección** — con systemd o OpenRC lo levanta
451el init; con arje-zero no lo hacía **nadie**. El síntoma no era «connection refused», que se
452diagnostica en un minuto: era un cuelgue que parecía del servidor. Arreglado en `netup` (es quien
453configura la red) y verificado desde la imagen, sin tocar la caja a mano.
454
455### 5.4 🚧 Lo que NO se puede todavía, y por qué importa
456
457Con todo lo anterior en verde, la caja **sigue sin poder instalar de su propio repo**:
458
459```
460release: trusted (by release)              ← la firma verifica
461repo: bajados 2 .swm de http://127.0.0.1   ← descarga de sí misma
462Error: no pude leer el apk db del lab en /.dev-fs/alpine/lib/apk/db/installed.
463       El toolchain entra en el ArtifactHash, así que sin rootfs no se puede
464       calcular un hash comparable
465```
466
467O sea: **la mitad de servir está cerrada y probada; la de consumir, no** — y no por un detalle de
468instalación, sino porque `install` **reproduce desde fuente** y eso exige el LAB ENTERO en el
469cliente. No es «falta un compilador»: el lab entra en el `ArtifactHash`, así que sin él no se puede
470ni calcular el hash a comparar.
471
472Es exactamente el punto que [SDD 27 §4](27-perfiles-instalables-y-el-instalador.md) dejó planteado
473y sin decidir —*reproducir o hidratar*— visto desde el otro lado: para un servidor, o para
474cualquiera que no sea un hub de build, **reproducir no es una opción**. El camino normal tiene que
475ser hidratar artefactos firmados, con `--reproduce` como camino auditable. Mientras esa decisión no
476se tome, el repo firmado sirve para distribuir **a hubs**, no a usuarios.
477
478⚠ **Y una caja que se sirve a sí misma es un solo origen** — justo lo que el ADR 0014 existe para no
479tener. El camino normal puede ser el local, pero la lista de orígenes del host debe incluir también
480el Storage Box o gioser. Si no, el primer origen roto es el último.
481
482**Lo que esto vale**: cerrar el bucle es el ensayo de «actualización en sitio probada de verdad»
483([SDD 19 §5.2](19-lanzamiento-publico.md)), hecho sobre una máquina que importa pero que **no es el
484laptop de nadie**.
485
486### 5.5 ⚠ Dos bugs más del lazo, que sólo aparecen si el paquete NO es un binario de Rust *(2026-09-21)*
487
488Pedido del usuario: «instalar zsh con el comando takana». `zsh` es el primer paquete que se instala
489**con varios parches** y **con el binario fuera de `/usr/bin`**, y cada una de esas dos cosas era un
490fallo distinto. Los dos son de la familia del `strip_debug` del §5.2 —algo que el `.swm` no
491transportaba fiel— y los dos **se descubren sólo cerrando el lazo**, no leyendo el código.
492
493**1. Los parches viajaban CONCATENADOS, y eso cambia el hash.** `pack` unía los N parches de la
494receta en el `patch` inline único; `Recipe::hash_inputs` mete **una entrada por parche** y
495`of_inputs` va con longitud prefijada ⇒ N sueltos y N unidos hashean distinto. Medido sin esperar al
496build, con una copia de `recipes/zsh.toml` con sus 6 parches concatenados en uno:
497
498```
499b3:0be3630d…   ← expected_hash anclado (y lo que hay en /store)
500b3:d6329a62…   ← lo que reconstruye el receptor  (= la copia concatenada, exacto)
501```
502
503O sea: `install zsh` recompilaba zsh **entero** y recién entonces moría con `expected_hash no
504coincide`. **Alcance: las 16 recetas del corpus con ≥2 parches** — waterfox 12, firefox y gnupg 11,
505parted/zsh/strace 6, doas/mandoc/giflib 4, freetype 3, libxml2/file/brotli 2…
506
507Arreglado con un campo `patches` (lista, en orden) en el `source_patch`; el `patch` único se sigue
508leyendo para no invalidar lo ya publicado. El receptor materializa **un fichero por parche**.
509Regresión con su **control negativo** en `swm_bridge`: si se concatenan, los `hash_inputs` TIENEN
510que diferir, o el test pasaría por la razón equivocada.
511
512⚠ La tentación era arreglarlo del otro lado —hashear los parches concatenados— y habría sido mucho
513peor: mueve el hash de las **50** recetas con parches e invalida sus artefactos sellados.
514
515**2. `target_bin` era una adivinanza que nadie comprobaba.** `pack` publica `/usr/bin/{name}`;
516`zsh` configura `--bindir=/bin`, así que su binario queda en `/bin/zsh`. El paquete se publicaba
517prometiendo un path que el artefacto no tiene, y el error salía **en la máquina que instala,
518después de hidratar los 1331 ficheros**:
519
520```
521Error: source_patch declara target_bin=/usr/bin/zsh pero no quedó en <prefix>/usr/bin/zsh
522```
523
524Con `--build` el artefacto está delante: ahora `pack` comprueba el path contra él y lo **corrige**
525si el binario quedó en otro bindir, diciéndolo.
526
527⚠ **Y el primer intento fue abortar, que era lo natural y estaba MAL.** Al publicar el perfil
528entero con esa versión, **65 de 175 paquetes se quedaron fuera del catálogo**: son las LIBRERÍAS
529—zlib, ncurses, openssl, musl-\*, gmp…—, que no traen ningún binario y existen para que otros las
530resuelvan como dep. Un campo que su consumidor ni mira habría tirado un tercio del repo. Así que
531no aborta: avisa, y el paquete se publica. Lo mide el barrido de abajo, no el razonamiento — esa
532versión pasaba los tests igual.
533
534**Publicando el perfil `servidor` entero con el `pack` arreglado** *(medido, store del hub)*:
535
536| | |
537|---|---|
538| publicados y firmados | **162** (el índice verifica contra su `trust`) |
539| **`target_bin` corregidos** | **8: `bash` `sed` `tar` `parted` `dhcpcd` `squid` `wpa_supplicant` `zsh`** |
540| sin binario (librerías) | 64 — se publican, con aviso |
541| sin sellar en ESTE store | 12 |
542| fallaron | 1 (`os-release`, el mismo del §6.46) |
543
544Esos 8 son paquetes que **estaban publicados prometiendo un path que no existe**: `install bash`
545habría hidratado y muerto al final. Comprobado después del arreglo, contra el repo firmado servido
546por HTTP: `parted` (6 parches **y** binario en `/usr/sbin`) instala en 0,17 s y responde
547`parted (GNU parted) 3.7`; `bash` instala y responde `5.3.0(1)-release`.
548
549### 5.7 El nombre ya existe: `repo.gioser.net` *(2026-09-21)*
550
551Dado de alta en la zona de Hetzner (la DNS de `gioser.net` está ahí: `helium`/`hydrogen`/`oxygen`),
552con la convención que ya usaban `takana`, `git`, `gitea`, `sergio` y `www`: **`repo` A →
5532.29.29.217, ttl 60**. Resuelve *(comprobado contra Cloudflare; el resolutor de Google todavía
554servía el NXDOMAIN cacheado — negativo de 1 h por el `minimum` del SOA, no es un fallo del alta)*.
555
556⚠ **La API vieja de DNS de Hetzner ya no es la buena.** `dns.hetzner.com/api/v1/zones` con
557`Auth-API-Token` devuelve **HTML de la consola web** (301 → 200 de una SPA), que es lo peor que
558puede devolver: no falla, contesta. Las zonas viven hoy en la **API de cloud** y las lee el MISMO
559token de `~/.config/hcloud/cli.toml`:
560
561```sh
562curl -H "Authorization: Bearer $TOKEN" https://api.hetzner.cloud/v1/zones          # gioser.net = 986350
563curl -H "Authorization: Bearer $TOKEN" https://api.hetzner.cloud/v1/zones/986350/rrsets
564```
565
566Durante unas horas el nombre resolvió y **no sirvió nada** —`http://` daba el 308 global de Caddy y
567el HTTPS moría en el handshake (`tlsv1 alert internal error`) porque sin site block no hay
568certificado—, hasta que se pudo entrar como root a la caja. **Cerrado el 2026-09-21** con
569`scripts/servidor/publicar-repo.sh --install-vhost`, que publica y firma en `/srv/repo`, añade el
570bloque y lo aplica; por defecto **imprime el bloque sin tocar el Caddyfile**, porque en esta caja
571Caddy sirve 19 dominios y su config ya acumula 20 `.bak`.
572
573⚠ **Publicar no es construir, y `repo-perfil.sh` no lo acotaba.** `pack --build` es instantáneo con
574cache-hit y una **compilación entera** si el artefacto no está sellado. Medido al ensayar el guion:
575la corrida se puso a compilar `libnftnl` —y después habría seguido con `rust`— en una caja de 4
576cores que ya estaba a **load 46**. `build-repo.sh` llevaba `timeout` desde siempre; el que se corre
577en producción, no. Ahora `BUILD_TIMEOUT` (120 s) y `SKIP_UNSEALED=1`: un vencimiento **no es un
578error**, significa «ése no estaba sellado». Con eso, el perfil entero publica **173 anclados, 0 sin
579ancla, 2 saltados (`os-release`, `rust`)** sin compilar nada.
580
581**El `--install-vhost`, probado en sus dos caminos** *(con un Caddy de juguete, porque el de la caja
582no tiene el admin abierto)*:
583
584| camino | qué pasó |
585|---|---|
586| reload OK | `✓ la config valida` → `✓ recargado`; el admin muestra el `srv1` nuevo sirviendo el repo **y el sitio que ya estaba sigue en pie** |
587| reload FALLA | copia restaurada **byte a byte** (`b"repo.local" not in` el fichero final), y no recarga nada |
588
589El orden es lo único que lo hace seguro: copia → añadir → `caddy validate` → **sólo entonces**
590`reload`. Un reload con la config rota no tira el sitio nuevo: tira los 19.
591
592⚠ **Y root no escribe en el árbol del usuario.** `work_root` sale de `dirname(store)/work` ⇒ con el
593store en `/store` es `/work`, donde `sources` y `out` son **enlaces a `/work/sergio/work/…`**, que es
594del usuario (CLAUDE.md §3 bis). Publicar como root dejaría ahí directorios de root y el siguiente
595build suyo moriría con un permiso denegado que no menciona la causa — es exactamente lo que ya pasó
596cuando root hizo `git pull` en el clon de tawasuyu y lo congeló para el dueño (`publicar-webs.sh`).
597El guion, si corre como root y nadie fijó `TAKANA_WORK`, lo manda a `/var/tmp/takana-publicar-work`
598y lo dice. Comprobado que el override no mueve el hash: `zsh` sella en `b3:0be3630d…` igual.
599
600⚠ **Y trae su propia guarda contra el error más fácil de cometer:** si el `takana` de la caja es
601anterior al §5.5 (se detecta porque no conoce `outdated`), **aborta antes de publicar**. Con uno
602viejo el repo sale con las 16 recetas multi-parche irreproducibles y 8 paquetes prometiendo un
603binario que no existe — y eso no se nota hasta que alguien instala.
604
605⚠ **Lo que queda vivo y no se tocó:** un `install <librería>` DIRECTO sigue fallando tras hidratar,
606porque el `.swm` exige que el `target_bin` exista y para una librería no hay respuesta buena. Hacer
607`target_bin` opcional toca el formato ([SDD 06](06-swm-format.md)) y es su propia unidad de trabajo.
608Como dep funcionan, que es para lo que están en el catálogo.
609
610**El lazo, después:** `takana install zsh --repo http://… --require-signed` ⇒ cache-hit del hash
611anclado, **1331 ficheros hidratados en 0,14 s**, y el binario corre (`zsh 5.9`). Antes: recompilar
612zsh entero para morir al final.
613
614### 5.6 `takana outdated` — el aviso que faltaba *(2026-09-21)*
615
616Ningún verbo comparaba lo instalado con el catálogo (`upgrade` es de **árboles/generaciones**, no de
617paquetes), así que «avisame cuándo hay que actualizar» no tenía respuesta. `outdated` la da leyendo
618sólo el índice firmado y la DB de instalados — no construye, no baja `.swm`, no escribe nada.
619
620**Compara por hash, no por versión**, y eso es lo único que lo hace útil: un repo se re-publica sin
621que cambie la versión upstream cada vez que se mueve algo que entra en `hash_inputs` (una flag, el
622lab, un parche), y mirar la etiqueta diría «al día» sobre un artefacto que ya no es el que el repo
623sirve. La versión es el respaldo para cuando falta el ancla, y se dice que el juicio es más débil.
624
625`scripts/servidor/avisar-actualizaciones.sh` lo corre por cron y **sólo grita cuando la lista de
626novedades cambia** (un guardián que repite lo mismo cada 30 min deja de leerse). Un repo caído no se
627disfraza de «al día»: lo dice, sale ≠ 0 y **conserva el último estado bueno**.
628
629⚠ **Lo que sigue sin poder hacerse, y no lo arregla ningún verbo:** actualizar en una máquina sin
630lab. El aviso llega a cualquiera; el `install` que lo resuelve sigue siendo reproducir desde fuente
631(§5.4). Por eso `outdated` **no actualiza**: instalar es verificar, y eso no se cuelga de un cron.
632
633### 5.8 Puerta 5, de verdad: `repo.gioser.net` sirve el repo firmado *(2026-09-21)*
634
635```
636$ takana install zsh --repo https://repo.gioser.net --trust ./trust --require-signed
637release: trusted (by release)
638repo: bajados 6 .swm de https://repo.gioser.net
639caché: artefacto ya en el store hash=b3:0be3630d… name=zsh
640  → hidratados 1331 archivo(s)                                    real 0m0,286s
641```
642
643**173 paquetes anclados, 0 sin ancla**, índice firmado con la clave de release de la caja y
644certificado `CN=repo.gioser.net` de Let's Encrypt. Los 2 que faltan (`os-release`, `rust`) no
645estaban sellados y el `SKIP_UNSEALED` los saltó en vez de ponerse a compilar.
646
647**Lo que había que descubrir para poder aplicarlo, y no estaba escrito en ningún sitio:**
648
649- **`caddy reload` NO sirve en esta caja.** El Caddyfile lleva `admin off` (por eso el `:2019`
650  siempre estuvo cerrado) y el `reload` de Caddy habla justamente por ese admin. La recarga real es
651  **`arjectl restart caddy`**: caddy es un Ente de arje (`/etc/arje/cards.d/caddy.json`,
652  `Restart{initial:1000,max:30000}`), no un proceso suelto.
653- **Un restart no es un reload: levanta los 19 dominios o ninguno.** Por eso el guion saca un
654  **testigo** de la config PREVIA —el primer dominio con nombre propio, acá `gitea.gioser.net`— y
655  espera a que vuelva a responder; si no vuelve, restaura la copia y revierte. Comprobado después:
656  los 8 dominios vivos siguen en pie (`gitea` 301 a `git`, el resto 200).
657- **El certificado tarda más que la comprobación.** El guion dio `✗ todavía no responde` y la misma
658  URL respondía **200 unos segundos después**: Caddy pide el certificado en la primera petición.
659  El mensaje ahora dice «reintentá el curl antes de buscar nada» en vez de mandar a leer logs.
660
661**El espejo provisional se quitó.** Mientras no hubo root, el catálogo estuvo servido **sin firmar**
662bajo `takana.gioser.net/repo` (un árbol escribible sin root, con certificado válido). Funcionó
663—`install zsh` en 0,22 s— y sirvió para probar el mecanismo, pero un origen sin firma no es un
664origen: con `repo.gioser.net` firmado en pie, se borró. Lo que quedó de aquello vale la pena
665recordarlo: **firmar con una clave que no es la de release habría sido peor que no firmar**, porque
666una autoría inventada se lee igual que una real; se publicó sin firma y con `--require-signed`
667rechazándolo, que es lo único honesto que se podía hacer sin la clave.
668
669⚠ **Sigue siendo un solo origen** (ADR 0014). La caja se sirve a sí misma; la lista de `--repo` de
670los clientes debería llevar también el Storage Box. El primer origen roto, si es el único, es el
671último.
672
673### 5.9 El aviso, enchufado en la caja *(2026-09-21)*
674
675`41 * * * *` en el crontab de root → `/usr/local/bin/avisar-actualizaciones`, un envoltorio de tres
676líneas que **sólo fija las rutas de la caja** (`REPO`, `DB`, `TRUST`, `STATE`, `TAKANA`) y llama al
677guion del repo. La lógica no se copia a propósito: el día que el guion cambie, el cron no se queda
678con una versión vieja — y se comprobó en vivo, arreglando el guion en el clon y viendo cambiar la
679salida del envoltorio **sin volver a desplegar nada**.
680
681Tres piezas que faltaban en la caja y ahora están:
682
683| | |
684|---|---|
685| `/var/lib/hammer/trust/release.ed25519.pub` | el almacén de confianza **por defecto** de la CLI, que no existía ⇒ `install`/`outdated` verifican la firma **sin pasar `--trust`** |
686| `/usr/local/bin/takana` | build release con el arreglo del §5.5. ⚠ El `PATH` de la caja **no incluye `/usr/local/bin`**, así que un `takana` a secas sigue siendo el del store (que no conoce `outdated`). El cron usa rutas absolutas. Ponerlo canónico es reconstruir la receta `takana` e hidratarla — su propia unidad de trabajo |
687| `/var/log/takana-actualizaciones.log` | una línea por hora |
688
689⚠ **Y la primera corrida real destapó un defecto del propio aviso**: con la DB de instalados vacía
690decía **«al día»**. Es verdad y no dice nada — peor, se lee como «comprobado y correcto» cuando lo
691cierto es que *no había nada que comprobar*. Un aviso que suena igual cuando vigila que cuando no
692vigila nada es exactamente cómo se deja de mirar un aviso. Ahora distingue: *«nada instalado por
693takana en esta máquina (DB …) — no hay qué comparar»*. Control en la caja con una DB de juguete
694(un `zsh` a otro hash): grita `1 con novedad · hash distinto`, y en la segunda corrida calla.
695
696Hoy la caja no instala de su propio repo —viene de imágenes—, así que el aviso dirá esa línea hasta
697que lo haga; se pone igual para que el día que instale algo ya esté, y porque una línea por hora no
698es ruido. Cada hora y no cada 30 minutos: el repo cambia cuando alguien publica.
699
700### 5.10 `takana install zsh` en el sistema de verdad — cinco cosas que faltaban *(2026-09-21)*
701
702El usuario escribió `sudo takana install zsh` en la caja y le contestó **«paquete 'zsh' no está en
703el repo /var/lib/hammer/repo. Disponibles: (ninguno)»**. Reproducido tal cual. Debajo de ese
704mensaje había cinco cosas distintas, y ninguna se ve hasta que alguien instala de verdad.
705
706**1. El repo por defecto no existía.** `DEFAULT_REPO` está cableado a `/var/lib/hammer/repo` y el
707repo publicado vive en `/srv/repo`. Un enlace (`/var/lib/hammer/repo → /srv/repo`) hace que
708`install <nombre>` sin `--repo` funcione **y sin pasar por la red**: un directorio local sirve
709igual que la URL.
710
711**2. El lab no se encontraba desde `/root`.** `install` reproduce desde fuente y el toolchain entra
712en el `ArtifactHash`, así que sin `.dev-fs` ni siquiera puede calcular el hash a comparar (§5.4).
713La resolución es `TAKANA_LAB` → hermano del store → hacia arriba desde el CWD; con el store en
714`/store` y el CWD en `/root`, ninguna acertaba. Enlace `/.dev-fs → /work/dev-fs` y la regla del
715**hermano del store** acierta desde cualquier directorio y para cualquier usuario. *(Los dos labs
716de la caja tienen el mismo `apk db` byte a byte, así que el `LabFingerprint` es el mismo.)*
717
718**3. El `takana` del sistema no podía leer los paquetes nuevos.** Los `.tkn` de hoy llevan los
719parches como **lista** (§5.5) y un cliente anterior ignora ese campo —serde salta lo desconocido—,
720así que reconstruiría **sin parches** y moriría contra el `expected_hash`. Se reemplazó por el
721build release. ⚠ Y se comprobó ANTES de tocar que `/usr/bin/takana` tenía `enlaces=1` e inodo
722distinto al del store: es una copia, no un hardlink. **Un `cp` encima de un fichero hidratado que
723SÍ fuera hardlink reescribiría el artefacto del store por debajo** — se borra y se pone uno nuevo,
724nunca se sobrescribe.
725
726**4. ⚠ La instalación quedó PARTIDA, y eso no lo dice ningún mensaje.** Sin `--prefix`, `install`
727abre un overlay sobre el FHS… pero sólo sobre **siete** directorios clásicos (`/bin`, `/usr/bin`,
728`/sbin`, `/usr/sbin`, `/lib`, `/usr/lib`, `/etc`). **`/usr/share` no está entre ellos**, así que de
729los 1331 ficheros de zsh, **1296 fueron directos al FHS real** y sólo los 2 binarios quedaron en el
730upper esperando el `commit`. El mensaje final dice `apply OK` igual. Un `discard` en ese estado
731habría borrado el binario y dejado 1296 ficheros huérfanos: *el experimento no era reversible y
732parecía que sí*.
733
734**5. ⚠ `commit` no puede desmontar `/bin` en una máquina viva.** Los procesos tienen su ejecutable
735**mapeado** desde ahí —empezando por PID 1, `/usr/bin/arje-zero`— y un ejecutable mapeado pin-ea el
736montaje. Resultado: desmontó 5 de 7 targets, murió con `target is busy` en `/bin`, y dejó **dos
737overlays montados con el estado sin promocionar**, que es el peor de los finales. El comentario del
738propio `do_umount_lenient` prometía el desmontaje perezoso desde la Fase 2 y **el código nunca
739pasaba `-l`**. Arreglado: ante `busy` reintenta perezoso, que desengancha el montaje ya mismo (las
740rutas vuelven a resolver al directorio real, que es lo que el promote necesita) y libera cuando el
741último proceso que lo miraba se muere.
742
743**El arreglo, probado en la caja viva** con un segundo paquete instalado de cero:
744
745```
746$ takana install tree           ⇒ overlay 1790022033-1575-000000
747$ takana commit 1790022033-1575-000000
748WARN takana_overlay: umount: el target estaba ocupado (procesos con ejecutables mapeados ahí,
749     normal en un FHS vivo) ⇒ desmontaje perezoso  target=/usr/bin
750commit OK — 1 archivo(s) promocionados, 0 eliminado(s) (anotado en el diario)
751⇒ overlays montados: 0 · /usr/bin/tree real · `tree v2.3.2` corriendo
752```
753
754Mientras tanto la caja se dejó limpia a mano: los dos binarios copiados al `/bin` REAL —visto a
755través de un `mount --bind /` no recursivo, porque el overlay tapaba el destino—, los dos montajes
756sueltos en perezoso y el estado borrado. Ahora: `zsh 5.9` en `/bin/zsh`, 1296 ficheros en
757`/usr/share/zsh`, **cero overlays**, y `takana installed` lo lista.
758
759**Y la trampa del §5.7 se cobró su pieza**: root dejó un `/work/swm-recipes` **suyo** dentro del
760`/work` del usuario (el catálogo de recetas que `install` materializa; `work_root` sale de
761`dirname(store)/work`). Devuelto a `sergio`. El guion de publicar ya exporta `TAKANA_WORK` para
762esto; `install` a secas no tiene esa defensa, y es deuda anotada.
763
764### 5.11 `chsh` no funcionaba, y las dos razones eran distintas *(2026-09-21)*
765
766Pedido del usuario después de instalar zsh. Dos capas, y sólo la primera es un arreglo.
767
768**1. `/etc/shells` no existía.** `chsh` de shadow rechaza cualquier shell que no esté en esa lista
769—para un usuario normal es un rechazo duro, no un aviso— y el fichero **no estaba en la caja**.
770Escrito con lo que EXISTE, comprobado `-x` uno por uno (`/bin/sh`, `/bin/ash`, `/bin/bash`,
771`/bin/zsh`) y no copiado de otra distro: *un shell listado que no está deja a quien lo elija sin
772poder entrar, y eso no se descubre hasta el siguiente login*. Con eso, `chsh -s /bin/zsh sergio`
773funciona y `su - sergio` entra con `zsh 5.9`.
774
775**2. ⚠ Pero `sergio` sigue sin poder cambiárselo él mismo, y eso no es un fichero que falte.**
776
777```
778$ su sergio -c "chsh -s /bin/bash"
779Cannot change ID to root.
780```
781
782Los cinco binarios de shadow que necesitan setuid root —`chsh`, `passwd`, `su`, `chfn`,
783`newgrp`— salen del store como **`r-xr-xr-x`**. No es que la hidratación pierda el bit: la receta
784lleva **`--disable-account-tools-setuid`**, heredado del APKBUILD de Alpine (donde esos binarios
785los hace setuid el *empaquetado*, no el configure — y acá no hay quien se lo reponga).
786
787Y hay una segunda capa debajo: **`ArtifactHash::of_tree` sólo hashea el bit de EJECUCIÓN**
788(`mode & 0o111`). O sea que hoy el modelo de artefactos **no puede ni expresar ni garantizar** un
789binario setuid: aunque la receta lo pusiera, el hash no lo cubriría y nadie notaría si se pierde o
790si aparece.
791
792⇒ **Quitar la bandera no alcanza y no es un arreglo de receta: es una decisión de seguridad.** Un
793setuid root en una distro de artefactos sellados necesita contestar quién lo pone, quién lo
794verifica y qué significa que el hash no lo cubra. Anotado, sin decidir.
795
796⚠⚠ **Y lo que de verdad hay que llevarse de esto: un overlay abierto se traga TODA la máquina.**
797Mientras el `/etc/shells` y el `chsh` se escribían, había un overlay abierto sobre el FHS —de un
798`takana install` sin `--prefix` que alguien había dejado sin commitear— y **las dos escrituras
799cayeron dentro de él**, aunque no tenían nada que ver con ese paquete ni pasaron por takana (fueron
800un `cat >` y el `chsh` de shadow). Medido con un `mount --bind /` no recursivo, que enseña el
801directorio real sin el overlay encima:
802
803| | `/etc` real | lo que se veía |
804|---|---|---|
805| `/etc/shells` | **no existe** | existe |
806| shell de `sergio` | **`/bin/bash`** | `/bin/zsh` |
807
808O sea: el trabajo estaba hecho «según la pantalla» y **un `discard` o un reinicio lo borraba**. Se
809resolvió con `commit` (5 ficheros promocionados: `passwd`, `passwd-`, `shells`, `zsh`, `zsh-5.9`) y
810ahí el desmontaje perezoso del §5.10 se ganó el sueldo: saltó en `/bin` **y** en `/usr/bin`.
811
812⇒ **`install` sin `--prefix` no es «un experimento para ese paquete»: cambia la semántica de
813escritura de la máquina entera hasta que alguien commitea o descarta.** Cualquiera que toque `/etc`
814mientras tanto —otro agente, un servicio, un humano por ssh— escribe en el upper sin enterarse. El
815overlay no avisa: no hay nada en el prompt, ni en `mount` a simple vista, ni un aviso al entrar.
816Como mínimo `takana status` tendría que salir en el arranque de sesión, y `install` debería decir
817**qué queda pendiente** en vez de un `overlay listo` que se lee como «terminé». Anotado.
818
819Consecuencia práctica mientras tanto: **los cambios de shell y de contraseña en esta caja los hace
820root**. Y una observación que sale de mirar esto: no hay `/etc/shadow`; las contraseñas viven en
821`/etc/passwd`, que es legible por todos, con hash DES clásico. No lo toqué — es su propia unidad de
822trabajo y afecta al arranque de la caja.
823
824---
825
826## 6. La mudanza como experimento: el criterio de borrado
827
828El usuario decidió que **gioser se borra** al final. Eso no es un detalle de calendario: es lo que
829convierte la mudanza en un experimento con criterio de aceptación, y hay que escribirlo **antes**.
830
831**Regla base**: un ausente falla ruidosamente; un vacío llega hasta el final diciendo que todo fue
832bien. Aplicado acá: *«lo copié»* no es prueba de nada. **La prueba es que el servicio responde en la
833caja nueva y que el dato se verifica por contenido.**
834
835### 6.1 Las puertas, en orden. Ninguna se salta.
836
837| # | puerta | cómo se comprueba |
838|---|---|---|
839| 1 | la caja nueva arranca **takana puro** y se entra por SSH | `ssh` a la IP nueva tras el reboot del rescue |
840| 2 | el **store** está entero | `1327` artefactos **y ninguno vacío** — `respaldo-storagebox.sh --listar` separa los vacíos; un directorio vacío **no** es un artefacto |
841| 3 | los **grafos** salen idénticos | `build-state.py` en las dos máquinas ⇒ los cuatro grafos **byte a byte**. Es la prueba de que un hub está bien montado, no que «funcione» |
842| 4 | la **granja** late en la caja nueva | una cosecha completa con el LXC enchufado por `.fleet` y artefactos que vuelven |
843| 5 | el **repo** se sirve y el host se actualiza de sí mismo | §5 en verde, con la clave estable |
844| 6 | cada dominio **vivo** responde 200 desde fuera | la tabla del §1.1, repetida contra la IP nueva |
845| 7 | el **respaldo** al Storage Box corre desde la caja nueva | una corrida completa, no un `--seco` |
846| 8 | lo **fósil** está anotado y decidido | lista del §1.1 con «muere» o «revive» al lado de cada uno |
847
848⚠ **Puerta 3 tiene una trampa conocida**: `sealed_remoto` dependía de la máquina (laptop 700, gioser
849751 sobre el MISMO corpus) y por eso se sacó del JSON. Si los grafos difieren, mirar primero si la
850diferencia es «cuánto de esto tengo en disco» y no «qué existe».
851
852### 6.3 Estado de las puertas *(2026-09-10)*
853
854| # | puerta | estado |
855|---|---|---|
856| 1 | arranca takana puro y se entra por SSH | ✅ §3.8 |
857| 2 | el store está entero | ✅ **1362 artefactos reales, 0 vacíos** |
858| 3 | los cuatro grafos idénticos | ✅ **byte a byte** — §6.7 |
859| 4 | la granja late en la caja nueva | ✅ **cosecha completa: 1369→1575, 0 vacíos** — §6.8 |
860| 5 | el repo se sirve y el host se actualiza de sí mismo | ⬖ mitad: sirve (§5.1), no consume (§5.4) |
861| 6 | cada dominio vivo responde 200 | ⬖ sondeados: **6 vivos de 19** — §6.9 |
862| 7 | el respaldo corre desde la caja | ⬖ alcanza el box y lista 3140; arreglados 3 bloqueos — §6.10 |
863| 8 | lo fósil, anotado y decidido | ✅ **decidido** — §6.9 |
864
865**Puerta 2, medida acotando al patrón `<hash>-<nombre>`**: 1362 artefactos, **0 vacíos**. Los 3 sin
866`.hammer/recipe.toml` son `stage1-rootfs`, `product-rootfs` y `seed-zig` — productos de bootstrap,
867que por diseño no salen de una receta. (El primer conteo dio «3 vacíos» y eran `.mirror-tmp`,
868`.bootstrap-tmp` y `.divergen`: directorios de trabajo con punto inicial, no artefactos. El chequeo
869tiene que acotar por el patrón, no listar el directorio.)
870
871**De paso, el disco**: la imagen ocupaba 7 G de los 76,3 G de la caja y los otros 69 eran
872inalcanzables. Arreglado en `install-image.sh` — el store pasa a ser la ÚLTIMA partición (la única
873que puede crecer sin mover datos) y el wrapper de `/sbin/init` la extiende en el primer arranque.
874Medido en la caja: **`/store` = 68,7 G**, contra los 487 M de antes. Con eso el store de 55 G entra
875en el disco local y **la mudanza no depende de mover el volumen de gioser**.
876
877### 6.4 ⚠ El muro de la puerta 3: la imagen trae 23 binarios que NO PUEDEN CORRER
878
879Al ir a computar los grafos en la caja:
880
881```
882$ python3 -c "print(1)"
883sh: python3: not found          ← y `command -v python3` decía /usr/bin/python3
884```
885
886No es que falte: **está y no arranca**. `/usr/bin/python3.12` son 23 MB y es un ELF **dinámico**:
887
888```
889Requesting program interpreter: /lib/ld-musl-x86_64.so.1
890NEEDED  libc.so
891```
892
893**Y en toda la imagen no hay ningún cargador dinámico.** Tampoco en el store: el artefacto `musl`
894publica sólo lo estático (`libc.a`, `crt*.o`, headers) — **no hay `libc.so` ni
895`ld-musl-x86_64.so.1` en ningún artefacto del corpus**. Lo que hace que estos binarios funcionen en
896gioser es el **rootfs Alpine del LAB**, que sí lo trae (`.dev-fs/alpine/lib/ld-musl-x86_64.so.1`).
897
898Es la fuga de [[needed-colgante-libstdcxx]] otra vez, y esta vez en el piso de abajo: *sella,
899reproduce y no corre*, porque pide algo que sólo existe en el laboratorio.
900
901**Contado sobre la imagen: 23 binarios inertes de 726 (703 estáticos están bien).** Son la suite
902`binutils` entera (`ar as ld nm objcopy objdump ranlib readelf strip addr2line c++filt elfedit gprof
903size ld.bfd`), más **`perl`**, **`python3`**, **`sqlite3`**, **`flex`** y **`nft`**.
904
905**Por qué frena la mudanza y no es un detalle**: *todo* el instrumental del proyecto es Python —
906`build-state.py`, `targets.py`, `yupana.py`, `hydrate-profile.py`, `drenar.py`, `triaje.py`. Un
907servidor takana no puede correr ni una de sus propias herramientas. La puerta 3 (los cuatro grafos)
908y la 4 (la granja) dependen de eso.
909
910**Y no se arregla de paso.** Las salidas son tres y ninguna es barata:
911
9121. **Publicar el cargador** — que `musl` emita `libc.so` + `ld-musl-x86_64.so.1`. Es lo correcto y lo
913   más chico en concepto, pero toca un componente de **Stage 1**: mueve el baseline `of_tree` del
914   selfhost y hay que rehacerlo a propósito, no de rebote.
9152. **Construir python/perl estáticos** — el camino que evita el cargador, y es un frente propio:
916   Python estático con módulos de extensión es notoriamente arisco.
9173. **Aceptar que el instrumental vive en el HUB** y que el servidor sólo sirve. Es la respuesta
918   honesta a corto plazo, pero contradice «mover allá todo lo que tengo acá»: el hub seguiría siendo
919   gioser, que es justo lo que se quiere apagar.
920
921Es decisión de ADR, y de las que conviene tomar mirando también el [SDD 27 §4](27-perfiles-instalables-y-el-instalador.md):
922las dos preguntas —«¿el cliente reproduce o hidrata?» y «¿el cliente puede correr lo que le
923mandamos?»— son la misma pregunta sobre qué es un sistema takana **sin laboratorio**.
924
925### 6.5 ✅ El muro, derribado: el corpus publica su propio cargador *(2026-09-11)*
926
927De las tres salidas del §6.4 el usuario eligió la 1 y la 2. Hecha la **1**, que resultó ser más barata
928de lo que parecía y desbloquea la 2 en vez de competir con ella.
929
930**`recipes/musl-shared.toml`** — variante dinámica de musl que publica `/usr/lib/libc.so` (4,2 M) y
931`/lib/ld-musl-x86_64.so.1`. En musl el cargador Y la libc son el mismo objeto.
932
933**Por qué una variante y no `--enable-shared` en la canónica**, con su control: `musl` es componente
934de **Stage 1** y su `of_tree` es el baseline de `selfhost-verify`. Tocarla obliga a rehacer ese
935baseline a propósito. Con el patrón `*-shared` —que el corpus ya usa 23 veces— la canónica no se
936mueve: `takana hash recipes/musl.toml` sigue dando `b3:ce952f72…`, el mismo sellado de Stage 1. Y
937además **`musl` no es dep de nadie** (medido: sólo de sí misma; el enlace estático lo resuelve el
938musl que trae zig), así que esto **suma sin mover un solo ArtifactHash del corpus**.
939
940#### ⚠ Y hubo que cambiar de compilador, medido
941
942Con `zig-cc` el `libc.so` sale con **1586 símbolos dinámicos** contra los **1654** del musl de Alpine,
943y los **68 que faltan son exactamente** los que musl implementa en ensamblador x86_64 — `memset`,
944`memcpy`, `memmove`, `memcmp`, `strlen` y toda la familia matemática (`ceil floor sqrt fmod exp log
945sin cos tan fma round trunc`) — más los `__stack_chk_*`.
946
947No es que no se compilen: en el `libc.a` del musl canónico **están**. Lo que pasa es que **zig los
948resuelve con su propio musl y los deja `FUNC LOCAL HIDDEN` de tamaño 0**, fuera de la tabla dinámica.
949El síntoma es un cargador que arranca, reloca y muere con `memset: symbol not found` — que se lee
950como «el binario está roto», no como «a la libc le faltan símbolos».
951
952Con `compiler = "gcc"`: **1651 símbolos**, `memset` y `ceil` presentes.
953
954#### El resultado, en la caja
955
956| antes | después |
957|---|---|
958| `sh: python3: not found` (con `command -v` contestando `/usr/bin/python3`) | `Python 3.12.10` |
959| 23 binarios inertes de 726 | **1** |
960
961`perl 5.040002`, `readelf`/`objdump`/`nm` (GNU Binutils 2.45.1) y el resto corren. El único que
962quedaba era **`sqlite3`**, con `Error loading shared library libz.so.1`: la zlib canónica también es
963`--disable-shared` y nadie publicaba ese soname. `zlib-shared` ya existía sellado en el corpus —
964sólo faltaba declararla en `base`.
965
966**La salida 2 (python/perl estáticos) sigue viva y ahora es opcional, no urgente**: con el cargador
967publicado el sistema ya no depende del rootfs del lab. Estático seguiría siendo mejor (un binario
968menos que puede quedar colgado de un soname), pero es un frente propio y ya no bloquea la mudanza.
969
970### 6.6 Sembrar el hub: un hub no es repo+store, es repo+store+LAB
971
972Con `python3` vivo, `takana hash` en la caja **seguía fallando**:
973
974```
975Error: no pude leer el apk db del lab en /.dev-fs/alpine/lib/apk/db/installed.
976       El toolchain entra en el ArtifactHash ⇒ sin rootfs no hay hash comparable.
977```
978
979**El lab es parte de la IDENTIDAD, no del entorno.** Una máquina sin él no puede ni preguntar «¿cuál
980es el hash vigente de esta receta?», así que no puede computar el grafo ni decidir qué falta. Sembrado
981el lab (tarball pineado + `tools/`, bajo `/store/dev-fs` porque la raíz son 6 G), el **hash testigo
982coincide byte a byte**: `takana hash recipes/zlib.toml` da `b3:dc363f26…` en las dos máquinas.
983
984⚠ **Y la caja no podía desempacar su propio lab**: el `tar` del rootfs es el de busybox y contesta
985`tar: unrecognized option: zstd`. La distro comprime todo con zstd —la imagen del lab, el respaldo,
986el `dd` remoto— y la imagen no traía el binario. `zstd` ya tenía receta sellada; declarado en `base`.
987
988#### ⚠⚠ Copiar un store con `rsync -a` es una fábrica de vacíos, y ahora se sabe POR QUÉ
989
990La primera copia murió con `No space left on device` en un `.so` de Qt, dejando el destino al 100 %
991y **1367 de 1368 artefactos VACÍOS**. La puerta 2 corrida EN EL DESTINO lo cazó en el acto.
992
993La causa, medida:
994
995| medición sobre el store de gioser | |
996|---|---:|
997| `du -sh` (hardlinks contados UNA vez) | **60 G** |
998| `du -sh --count-links` (hardlinks EXPANDIDOS) | **85 G** |
999| `.dmerge` (la caché que hardlinkea al store) | **11 G** |
1000
1001**`rsync` sin `-H` no preserva hardlinks: los expande en copias enteras.** Así que «el store son 60 G»
1002—que es lo que dice `du` y lo que uno planifica— se convierte en 85 G + lo que `.dmerge` expanda al
1003otro lado. La partición de 68,7 G no tenía ninguna chance, y el modo de fallar es el peor: el disco se
1004llena a mitad y quedan cientos de nombres de artefacto sin contenido, que el store da por presentes.
1005
1006La copia correcta es **`rsync -aH --exclude='.dmerge'`**: `-H` preserva los enlaces (60 G reales) y
1007`.dmerge` no se copia porque es caché regenerable — la misma que ya llenó un disco en el worker.
1008
1009**La lección de método**: `du -sh` sobre un árbol con hardlinks **no** dice cuánto ocupa copiarlo.
1010Para dimensionar una copia hay que medir con `--count-links`, o preservar los enlaces.
1011
1012#### Y el instrumental apunta al binario de DESARROLLO, no al instalado
1013
1014La primera corrida de `build-state.py` en la caja devolvió **875 recetas `unhashable`** — todas —
1015con el lab bien sembrado y `takana hash` funcionando a mano. La causa:
1016
1017```python
1018HAMMER = os.environ.get("HAMMER", str(ROOT / "target/release/takana"))
1019```
1020
1021Los scripts asumen un **árbol de desarrollo**: `target/release/takana`. En una caja **instalada** el
1022binario es `/usr/bin/takana` y `target/` ni existe (la siembra lo excluye a propósito). No falla
1023ruidosamente: cada `hash` falla y el grafo sale entero como `unhashable`, que se lee como «este
1024corpus no se puede hashear» y no como «no encontré el binario».
1025
1026Se destraba con `HAMMER=/usr/bin/takana STORE=/store`, que la propia cabecera del script documenta.
1027Pero la deuda queda anotada: **el instrumental debería caer a `command -v takana`** antes de rendirse,
1028porque el caso «hub instalado» es justamente el que esta mudanza quiere que exista.
1029
1030### 6.7 ✅ PUERTA 3 EN VERDE: los dos grafos, idénticos byte a byte
1031
1032```
1033gioser: 7435d33d62577e8ce154e8c5e354e0465139cfbc632afe710076ea2223cea605
1034caja:   7435d33d62577e8ce154e8c5e354e0465139cfbc632afe710076ea2223cea605
1035```
1036
1037`base 61/61 · cli 84/84 · escritorio-mirada 41/41 · servidor 96/96 · falta 0`, `wanted 3`
1038(`chrony`, `cronie`, `logrotate` — la deuda declarada), grafo CIERRA, topo-sort OK. Las dos máquinas.
1039
1040**Costó tres intentos, y los dos fallos son la parte que vale.**
1041
1042**Intento 1 — `unhashable 875`**, todas. Ver arriba: los scripts apuntan a `target/release/takana`.
1043
1044**Intento 2 — dos nodos divergentes**: `aichat` y `zola`, `sealed` en gioser y `never` en la caja. No
1045era deriva ni pérdida: **ninguno de los dos está en disco en gioser tampoco**. Son los «2 sellados
1046que no están en esta máquina, avalados por los manifiestos» que el propio resumen imprime.
1047`build-state.py` lee `work/farm-sellados.txt` y `work/respaldo-sellados.txt` — y **`work/` está
1048gitignored**, así que un hub recién sembrado no los tiene y degrada esos nodos a `never` sin que nada
1049falle.
1050
1051Es la misma familia que `scripts/farm/.fleet`: **un fichero fuera de git del que depende una medición
1052compartida**. La regla que sale: *sembrar un hub no es clonar el repo — es repo + store + lab +
1053los manifiestos*. Copiados los dos ficheros, los grafos coinciden exactamente.
1054
1055### 6.8 Puerta 4: el camino de la granja, PROBADO; la cosecha completa, sin disco
1056
1057**Probado desde la caja** (sin tocar el latido de gioser, todo de sólo lectura salvo el último paso):
1058
1059- llevada la clave de la granja (`~/.ssh/github5` → `/root/.ssh/github5`, 0600) y escrito
1060  `scripts/farm/.fleet` — los dos están fuera de git a propósito y hay que copiarlos a mano;
1061- la caja **alcanza al worker**: `PruebasIA`, load 3, 775 artefactos;
1062- `estado-granja.sh` corre allá y lee bien el worker y el avance KDE (198/199);
1063- y el paso que cierra el lazo: se **cosechó un artefacto real del worker** (`speedtest-go`, 12 M)
1064  con el mismo transporte de la granja, llegó **con su `.hammer/recipe.toml`** y **su binario CORRE
1065  en la caja** (`speedtest-go v1.7.10`). Worker construye → hub cosecha → binario ejecuta.
1066
1067#### ✅ CERRADA (2026-09-11) con el volumen `takana-store`
1068
1069Resuelto el disco (§6.12), la cosecha completa corrió: **1369 → 1575 artefactos, 0 vacíos**, que son
1070exactamente los 206 que faltaban. 12,4 G por la red para 39 G lógicos —`speedup 3.14`, el ahorro de
1071`-H`— y `/store` queda en 73,7 G de 97,9 (79 %).
1072
1073⚠ El enlace con el worker va a **11 MB/s**, no a los 90 MB/s de gioser↔caja: el LXC vive en el
1074Proxmox de gioser, fuera de la red de Hetzner. Media hora para una cosecha de este tamaño.
1075
1076⚠ **Lo que faltaba no era mecanismo: era DISCO.**
1077
1078| | |
1079|---|---:|
1080| artefactos en el worker que la caja no tiene | **206** |
1081| a ~113 MB de media (el artefacto medio del corpus) | **~23 G** |
1082| libre en `/store` de la caja | **3,7 G** (61,5 de 68,7 · 94 %) |
1083
1084Una cosecha completa **no entra**, y forzarla repetiría exactamente el llenado que dejó 1367
1085artefactos vacíos hace un rato. La puerta 4 queda pendiente de una decisión de CAPACIDAD, no de una
1086de ingeniería:
1087
10881. **Enganchar `harkaq-cosecha` (250 G) a la caja.** Es el plan original y no cuesta nada extra —
1089   pero hay que DESENGANCHARLO de gioser, y ahí vive el store, `work/sources`, los tarballs y el
1090   `CARGO_HOME` de la granja. O sea: **es el cutover**. gioser deja de construir en ese mismo
1091   instante, y hoy está moliendo el árbol KDE.
10922. **Un volumen nuevo para la caja** (€0,052/GB/mes: 100 G ≈ €5,2/mes). No interrumpe nada y
1093   destraba la cosecha ya; se paga por duplicado hasta que gioser muera, y entonces se suelta.
10943. **Podar el store de la caja** — deshace parte de la mudanza. No.
1095
1096### 6.9 Puerta 8: los 19 dominios, sondeados uno por uno *(2026-09-11)*
1097
1098El Caddyfile de gioser declara 19 sitios. Sondeados por DNS **y** por HTTP desde fuera, sólo **6**
1099los sirve gioser de verdad:
1100
1101| dominio | DNS | HTTP | qué es |
1102|---|---|---|---|
1103| `gioser.net` · `tawasuyu.net` | gioser | **200** | **VIVO** — las dos landings |
1104| `git.gioser.net` · `git.tawasuyu.net` | gioser | **200** | **VIVO** — el gitea (aloja el `origin` de takana) |
1105| `sergio.gioser.net` · `api.sergio.gioser.net` | gioser | **200** | **VIVO** |
1106| `summa` · `api.summa` · `dev.summa` | **154.197.1.2** | 200 | **YA MUDADOS** a otra máquina: el bloque de Caddy en gioser es fósil aunque el sitio viva |
1107| `api.gioser.net` | gioser | **502** | backend caído |
1108| `mail.sigma.gioser.net` | gioser | **502** | backend caído |
1109| `aura` · `api.aura` · `sigma` · `kosmofono` · `api.kosmofono` | **SIN DNS** | — | fósil: ni DNS ni ficheros en `/var/www` |
1110| `terapeuta.ec` · `andino.ec` | **SIN DNS** | — | fósil con datos: 279 M en `/var/www/terapeuta` |
1111| `gitea.gioser.net` | **SIN DNS** | — | era un `redir` a `git.gioser.net`; inofensivo |
1112
1113**Lo que esto cambia respecto del §1.1**: no son «4 fósiles» sino **13 de 19 entradas que no hay que
1114mudar** — 8 sin DNS, 2 con el backend caído y 3 que ya viven en otra máquina. La superficie real a
1115mudar son **6 sitios**, y de esos el que pesa es el **gitea**, porque aloja el `origin` de takana.
1116
1117#### ✅ DECIDIDO (usuario, 2026-09-11)
1118
1119| fósil | decisión |
1120|---|---|
1121| `aura` · `api.aura` · `sigma` · `kosmofono` · `api.kosmofono` | **mueren** — ni DNS ni ficheros |
1122| `gitea.gioser.net` | **muere** — era un `redir`, y `git.gioser.net` lo cubre |
1123| `api.gioser.net` · `mail.sigma.gioser.net` | **mueren** — backend caído, sin dueño |
1124| `summa` · `api.summa` · `dev.summa` | **no se mudan**: ya viven en 154.197.1.2. Sólo hay que sacar sus bloques del Caddyfile al apagar gioser |
1125| **`terapeuta.ec` · `andino.ec`** | **MUEREN** — decisión explícita del usuario. Los 279 M de `/var/www/terapeuta` se van con la caja; **no se archivan** |
1126
1127⇒ De las 19 entradas del Caddyfile, **13 no se mudan**. La superficie real es de **6 sitios**, y el
1128que pesa es el gitea porque aloja el `origin` de takana.
1129
1130⚠ Que esto quede escrito ES la puerta: el día que se borre gioser, `terapeuta.ec` no va a poder
1131recuperarse, y la diferencia entre «lo decidimos» y «se nos pasó» es este párrafo.
1132
1133### 6.10 Puerta 7: el respaldo desde la caja — y tres bloqueos que sólo se ven corriéndolo
1134
1135Llevadas las credenciales (`~/.config/hammer/*.env`, 0600) y la clave, **la caja alcanza el Storage
1136Box** por el puerto 23 y lista su contenido. El manifiesto se refresca desde allá:
1137**3140 artefactos**, y de paso el script detecta **2 VACÍOS en el respaldo** (`gnome-desktop` ×2) que
1138excluye del manifiesto — su propia guarda, funcionando.
1139
1140Para llegar ahí hubo que arreglar **cinco** cosas, y todas son de la misma familia: *el instrumental
1141asume que el hub es gioser*. El `--seco` ahora completa los tres pasos desde la caja y lee la
1142ocupación del box (111 G de 1 T).
1143
11441. **La raíz cableada.** `RAIZ="${RAIZ:-/mnt/vvv/takana}"` ⇒ desde cualquier otra máquina el script
1145   moría con `cd: /mnt/vvv/takana: No such file or directory`. Ahora se deriva de dónde está el
1146   script, como el resto de `scripts/`.
11472. **El binario de desarrollo.** `HAMMER = ROOT/target/release/takana` (§6.7).
11483. **El store no estaba donde el script creía.** Usaba `$RAIZ/store` cableado: en gioser es un
1149   bind-mount DENTRO del repo, pero en una caja instalada es una partición en `/store` ⇒
1150   `change_dir "/opt/takana/store" failed`. Y rsync devuelve **23**, que está en la lista de
1151   reintentables, así que el bucle insistía — el cuadro que la propia cabecera del script documenta
1152   («un error reintentable que se repite 40 veces no es un corte de red: es algo estructural»).
1153   Ahora `STORE` es env, con una guarda que aborta ANTES del bucle si la ruta no existe.
11544. **🚨 Y una que habría costado el historial.** El paso [2/3] sube el repo **con `--delete`** —
1155   correcto, para eso está git. Pero el `/opt/takana` de la caja llegó por `rsync --exclude=.git`:
1156   es una COPIA, no un clon. **Una corrida real desde ahí habría borrado `.git` del Storage Box**, o
1157   sea el historial entero, y en silencio: rsync haría exactamente lo que se le pidió. Añadida una
1158   guarda que aborta si la raíz no tiene `.git` (escotilla `REPO_INCOMPLETO=1`), probada en los tres
1159   sentidos.
1160
1161   **La regla que sale**: un `--delete` convierte «respaldar» en «sincronizar», y sincronizar desde
1162   un origen incompleto no sube menos — BORRA. Cualquier respaldo con `--delete` necesita una guarda
1163   de completitud del ORIGEN, no sólo del destino.
11645. **El rsync del corpus no puede correr el respaldo del corpus.** El script exige
1165   `--compress-choice=zstd` y `recipes/rsync.toml` lo construía con `--disable-zstd` — porque cuando
1166   se escribió, `zstd` no estaba en el catálogo. Hoy sí. Peor aún: el error 4 que devuelve rsync el
1167   script lo clasifica como «no de red» y **no reintenta**, así que el respaldo simplemente no se
1168   hacía. Arreglado por los dos lados: la receta enciende zstd (control: `zstd zlibx zlib none` vs
1169   `zlibx zlib none`; radio cero, `rsync` no es dep de nadie) y **el script degrada a zlib avisando**
1170   en vez de morir.
1171
1172### 6.11 ⚠ La distro traía un `git` que NO PODÍA CLONAR
1173
1174Para cerrar la puerta 7 la caja necesita un **clon de verdad** (el `--delete` del respaldo exige un
1175origen completo, §6.10). Llevada la clave del gitea —que es `~/.ssh/tawasuyu`, **no** la de la
1176granja— `git ls-remote` contesta… y `git clone` muere:
1177
1178```
1179fatal: fetch-pack: invalid index-pack output
1180```
1181
1182El informe completo, que la traza corta escondía:
1183
1184```
1185panic: load of misaligned address 0x… for type 'const uint32_t',
1186       which requires 4 byte alignment
1187  in sha1_compression_states → sha1_process → SHA1DCUpdate → git_SHA1DCUpdate
1188  → git_hash_update → unpack_entry_data → cmd_index_pack
1189```
1190
1191**Dos causas, encadenadas:**
1192
11931. **`-fsanitize=undefined` estaba en `CFLAGS`**, no sólo en `LDFLAGS`. El motivo original era
1194   legítimo —las `libz.a` materializadas traen referencias `__ubsan_handle_*` que bajo `-static` no
1195   se resuelven solas, y el flag *al enlazar* trae el runtime de zig— pero en `CFLAGS` **instrumenta
1196   el código de git**. Un arreglo de ENLACE convertido en una mina de RUNTIME, justo en la ruta de
1197   hash: por donde pasa todo lo que git recibe.
11982. **`sha1collisiondetection` lee palabras de 32 bits SIN alinear.** Es el backend SHA1 por defecto
1199   de git, el que detecta SHAttered. En x86 la lectura desalineada funciona y por eso nadie lo nota
1200   jamás; según el estándar es UB, y basta con que el runtime ubsan esté enlazado para que aborte.
1201   `-DSHA1DC_FORCE_ALIGNED_ACCESS` lo hace leer byte a byte: quita el UB **en la fuente** en vez de
1202   esconderlo.
1203
1204Con las dos: `git clone --depth 1` del propio repo desde la caja ⇒ **877 recetas**. Radio cero
1205(`git` no es dep de nadie), pero **sí es raíz de `perfil.base`** ⇒ esto arregla la distro entera.
1206
1207**La lección**: `ls-remote` andaba, así que el fallo parecía de red. Lo que lo destapó fue leer el
1208informe COMPLETO en vez de la última línea — la primera decía exactamente qué y dónde.
1209
1210### 6.12 ⚠ La caja dejó de ser desechable — y `hydrate` no cruza el store
1211
1212Dos consecuencias de que la caja ya sea un hub, y las dos cambian el procedimiento:
1213
1214**1. Re-escribir la imagen con `dd` ya NO es una actualización, es una pérdida.** El `dd` sobrescribe
1215el disco local, y ahí viven ahora `/opt/takana` (el clon), `/root/.ssh` (las dos claves),
1216`/root/.config/hammer` (las credenciales del respaldo), `/srv/repo` y la configuración de caddy. El
1217store se salva sólo porque está en el volumen. **Y hay una trampa peor**: la imagen etiqueta su
1218partición local como `hammer-store`, así que tras un `dd` habría **dos filesystems con esa etiqueta**
1219y el `findfs` del arranque elegiría cualquiera — con suerte el volumen, con mala suerte una partición
1220vacía. ⇒ el `dd` es para PROVISIONAR; actualizar es `takana upgrade` (que existe, con generaciones y
1221rollback) y está sin probar en esta caja.
1222
1223**2. `takana hydrate` no puede proyectar al root vivo.** Hidratar enlaza en DURO, y en una caja
1224instalada el store es **siempre** otra partición que `/`:
1225
1226```
1227Error: store: hardlink /store/51aa5e13…-git/.hammer/recipe.toml → /.hammer/…: Cross-device link
1228```
1229
1230No es culpa del volumen: en el layout original `/store` es `sda4` y `/` es `sda2`, también distintos.
1231**Hidratar al FHS vivo nunca fue posible en una caja instalada** — funciona en el hub porque ahí
1232store y destino están en el mismo filesystem. Es la misma familia de EXDEV que ya mordió dos veces
1233(§6.6), ahora a nivel de sistema y no de herramienta.
1234
1235Para instalar el `git` arreglado se copió el artefacto a mano. Eso **funciona y no es el camino**: el
1236camino es `takana upgrade`, y probarlo es su propia unidad de trabajo.
1237
1238### 6.13 ✅ `takana upgrade`, probado de verdad — y el bug de durabilidad que destapó
1239
1240§6.12 dejó dicho que el camino de actualización de una caja instalada es `takana upgrade`, no `dd` ni
1241`hydrate`. Probado con un paquete que la caja **realmente necesitaba**: `zstd`.
1242
1243| paso | resultado |
1244|---|---|
1245| `upgrade apply …-zstd-cli` | `✓ generación 2 aplicada · + 1 añadidos, ~ 1 pisados, - 8 retirados` |
1246| la prueba de uso | `zstd -dc lab-image.tar.zst \| tar -xf -` ⇒ **la caja desempaca su propio lab** |
1247| `upgrade rollback` | `✓ generación 2 revertida · 9 restaurados, 1 borrados` — `zstd` se va, `libzstd.a` vuelve |
1248| re-`apply` + **corte duro sin `sync`** | sobrevive: generación viva 1, manifiesto íntegro |
1249
1250✔ **Y cruza la frontera que `hydrate` no puede**: el store está en el volumen y `/` en el disco local,
1251y `upgrade` copia en vez de enlazar. Es, de hecho, el único camino que funciona en una caja instalada.
1252
1253#### ⚠ El bug: `write_atomic` era atómico pero NO DURABLE
1254
1255El primer intento pareció funcionar y **se perdió al reiniciar**. La caja volvió con:
1256
1257```
1258pending.json                   0 bytes
1259generations/2/manifest.json    0 bytes
1260upgrade status  → Error: json: EOF while parsing a value
1261upgrade recover → Error: json: EOF while parsing a value
1262```
1263
1264`write_atomic` hacía temporal + `rename`: atómico frente a otros PROCESOS, no frente a un CORTE.
1265`rename` sobre un fichero cuyos datos siguen en caché deja, tras el corte, la entrada apuntando a
1266bloques nunca escritos — cero bytes. Y `hcloud server reset` **es un corte duro**, no un apagado
1267limpio: ahí está la mitad operativa de la lección.
1268
1269Lo grave no es perder un upgrade: es que **`recover` —que existe exactamente para «un apply
1270interrumpido por un corte»— abortaba con la huella más probable de ese corte**.
1271
1272Arreglado: `fsync` del temporal antes del `rename` y `fsync` del directorio después (hacen falta los
1273dos), y un `pending.json` vacío se reporta como `PendingCorrupt`, nombrando el corte y apuntando al
1274árbol de respaldos. Con tests y su control.
1275
1276**Verificado en la máquina, en los dos sentidos**: con el binario viejo, apply + reset duro ⇒ estado
1277en 0 bytes; con el nuevo, la misma secuencia ⇒ estado íntegro y el paquete en su sitio.
1278
1279#### ⚠⚠ `upgrade apply` NO es un gestor de paquetes: cada generación ES UN ÁRBOL
1280
1281Lo destapó usarlo dos veces seguidas. Tras aplicar `zstd-cli` y después `rsync`:
1282
1283```
1284✓ generación 2 aplicada
1285  + 0 añadidos, ~ 8 pisados, - 1 retirados      ← el `zstd` de la generación 1
1286$ zstd --version
1287AUSENTE
1288```
1289
1290**Aplicar un árbol nuevo RETIRA los ficheros del anterior**, porque una generación es el estado
1291completo, no un incremento. Es coherente con lo que la ayuda dice —«aplica un árbol Stage1/**producto**
1292del store»— y con que exista `rollback`: lo que se revierte es un sistema, no un paquete.
1293
1294⇒ Usarlo para instalar paquetes sueltos, como hice acá, funciona una vez y se deshace a la siguiente.
1295**La forma correcta de poner una caja al día es componer el árbol del perfil —lo que ya hace
1296`servidor-image.sh`— sellarlo, y aplicar ESO como una generación.** Eso además sería, de verdad, la
1297«actualización en sitio probada» del [SDD 19 §5.2](19-lanzamiento-publico.md): una imagen entera, con
1298rollback, sobre una caja viva.
1299
1300Mientras tanto la caja quedó con `zstd` y `rsync` puestos a mano — funciona y **no es el camino**,
1301igual que el `git`.
1302
1303⚠ Lo que NO se arregló: si el manifiesto se pierde, `recover` no puede deshacer solo — no sabe qué se
1304tocó. El árbol de respaldos tiene la información; reconstruir desde ahí es su propia unidad.
1305
1306### 6.2 Lo que la mudanza tiene que producir, además de la mudanza
1307
1308El usuario lo pidió explícito: **que este experimento saque recetas y las pruebe**. La caja vieja es
1309un catálogo de software real en producción, y cada servicio que hoy corre sobre binarios de Artix es
1310una receta candidata con un caso de uso comprobado detrás:
1311
1312| lo que corre hoy en Artix | receta |
1313|---|---|
1314| `caddy` | ✅ existe (`recipes/caddy.toml`) |
1315| `openssh` | ✅ existe |
1316| `gitea` | ✅ **SÍ existe** (`recipes/gitea.toml`) **y está sellada** (`35bb4f04…`) — ver la corrección abajo |
1317| `qdrant`, `squid`, `fail2ban`, `php-fpm`, `metalog`, `glances` | ✗ |
1318| `chrony`, `nftables`, `cronie`, `logrotate` | ✗ — ya declaradas `wanted` en `perfil.servidor` |
1319
1320> **CORRECCIÓN (2026-09-11).** Esta tabla decía que `gitea` NO tenía receta y que «es la que más
1321> peso tiene». **Las dos cosas eran falsas**: `recipes/gitea.toml` existe desde el 2026-09-09 y su
1322> artefacto está sellado. Lo escribí de memoria, sin mirar el catálogo.
1323>
1324> Lo destapó `planear.py` al cruzar cada binario contra `recipes/`: de los servicios de gioser, **4
1325> ya tienen receta takana y están sellados** (`caddy`, `gitea`, `python3`…), 4 vienen de un paquete
1326> ajeno y **11 son binarios sueltos sin dueño**. Ésos últimos son el trabajo real, no gitea.
1327>
1328> Es exactamente para esto que la herramienta existe: yo afirmé de memoria y el programa fue a mirar.
1329
1330**Cada una que se cierre se prueba sola**: el servicio o levanta en la caja nueva o no, y eso se ve
1331el mismo día. Es la diferencia entre una receta «sellada» y una receta *usada*.
1332
1333---
1334
1335### 6.11 🗄️ La imagen del perfil, con gitea, ARRANCA y SIRVE *(2026-09-14)*
1336
1337`servidor-image.sh` + QEMU: **PID 1 = `arje-zero`, gitea encarnado por él (`ppid=1`), corriendo como
1338`uid=916`, escuchando en :3000 y devolviendo `200` con `<title>takana git</title>`**, con su
1339`gitea.db` creada por él mismo. Es el primer servicio de PAQUETE que arranca en una imagen de takana:
1340los que había venían horneados en el bootstrap.
1341
1342La cadena entera, eslabón por eslabón: `[[user]]` → `/etc/passwd` de la imagen · `[[service]]` →
1343`takana service-cards` → `genesis` de la seed → arje lo encarna → `setuidgid` → sirve.
1344
1345#### Los tres fallos que sólo aparecieron AL PROBAR LA IMAGEN
1346
1347Los tres pasan el sellado, el `hash`, el resolutor de servicios y el armado. Ninguno se ve sin
1348arrancar la imagen.
1349
13501. **⚠⚠ Escribir en el rootfs hidratado es escribir DENTRO del store.** `takana users --merge` hacía
1351   `fs::write` sobre `<rootfs>/etc/passwd`, y ese fichero y el del artefacto `product-rootfs` son
1352   **el mismo inode** (medido: 1225824, `2 links`, modo `444`) — el rootfs se arma con hardlinks.
1353   Habría mutado un artefacto sellado, y toda imagen futura habría salido con la cuenta metida dentro
1354   del producto. Se salvó porque el store es de sólo lectura y salió `Permission denied`: confiar en
1355   eso es confiar en un permiso. Ahora escribe por temporal + `rename`, con un control que comprueba
1356   que el fichero del store conserva su contenido y baja a 1 link.
1357
13582. **La imagen traía el binario, la cuenta… y nadie lo arrancaba.** El `genesis` sólo tenía lo que
1359   hornea `takana-bootstrap` (`sshd`, `console-getty`, `hammerd`): `servidor-image.sh` **no inyectaba
1360   las Cards** — eso sólo existía en el camino de las imágenes de escritorio. Y ninguna métrica lo
1361   dice: `targets.py --services` responde que el perfil lo habilita, y lo habilita; lo que faltaba era
1362   el paso que lleva esa declaración a la imagen.
1363
13643. **⚡ `trap invalid opcode`: el binario sólo corría en la CPU que lo compiló.** Con la card ya en el
1365   genesis, gitea moría al instante dentro de QEMU-TCG. El sandbox exporta `CC` apuntando a un wrapper
1366   con `-mcpu=baseline` (y su comentario ya avisaba: «de paso cierra el SIGILL de AVX en qemu64»), y
1367   **la fase Go del propio builder lo pisaba** con `CC="zig cc"` a secas, que es `-mcpu=native`. No
1368   falla al compilar ni al sellar: falla al ejecutar en otra CPU. Y el `ArtifactHash` no puede
1369   cazarlo, porque la CPU del builder no entra en `hash_inputs` — **dos workers distintos sellan bytes
1370   distintos bajo la misma dirección**. Arreglado en el builder y en la receta; re-hashea las cinco
1371   recetas `cgo = true` (`gitea`, `usql`, `sq`, `gocryptfs`, `naabu`).
1372
1373#### Lo que NO está probado, y falta para la mudanza
1374
1375El `app.ini`, el usuario del sitio y los datos se pusieron **a mano** dentro de la VM para llegar al
1376200. Eso es exactamente lo que el plan de mudanza tiene que traer de gioser — `/etc/gitea` ya está en
1377`scripts/mudanza/rutas-fuera-de-git.txt`.
1378
1379Y **la imagen no trae `arjectl`**: tras poner la config hubo que REINICIAR para que arje volviera a
1380intentarlo. El backoff de `restart` se agota y no hay forma de pedirle a PID 1 que relance un ente en
1381caliente. Para una caja de producción eso es una pieza que falta, no una comodidad.
1382
1383### 6.12 🎛️ `arjectl` en la imagen: control en caliente *(2026-09-14)*
1384
1385El §6.11 cerró con «la imagen no trae `arjectl`, hubo que reiniciar la máquina para arrancar un
1386servicio». Ya lo trae, y **no hubo que escribir nada**: el cliente existía en tawasuyu y se llama
1387**`arje-ctl`** (el crate; el binario es `arjectl`). Buscarlo por `arjectl` no lo encontraba, y de ahí
1388salió la conclusión falsa de que faltaba implementarlo — el protocolo (`arje-bus::BusRequest`) ya
1389traía `ListEntes`, `SpawnCardFromDisk`, `StopCardFromDisk`, `KillEnte` y `EnteStatus`.
1390
1391`recipes/arjectl.toml` lo construye **del mismo commit que `arje-zero`** (`98db584f`), y eso no es
1392comodidad: el bus es un protocolo entre dos binarios, y un cliente de otro árbol puede conectar y no
1393entenderse con el init. Publica **sólo `arjectl`**; el crate también produce un `systemctl` de
1394camuflaje que acá no se instala — un `systemctl` en el PATH de una distro sin systemd invita a
1395escribir runbooks con el verbo ajeno.
1396
1397#### El hueco que sólo se ve usándolo: el genesis no alcanza
1398
1399Con `arjectl` en la imagen, el primer intento falló con un mensaje que nombra la causa:
1400
1401    $ arjectl start gitea
1402    Error: arje-zero rechazó: card gitea: No such file or directory
1403           (buscada en /etc/arje/cards.d/gitea.json)
1404
1405`start`/`restart` usan `SpawnCardFromDisk`, que lee **`/etc/arje/cards.d/<label>.json`** — y el
1406armado sólo escribía el `genesis` de la seed. Son dos preguntas distintas: *qué arranca solo* y *qué
1407se puede encarnar a pedido*. Con sólo la primera, un servicio que agota su backoff **no se puede
1408relanzar sin reiniciar la máquina**. `inyectar-cards.py` escribe ahora los dos árboles (y en
1409`cards.d` escribe TODAS, no sólo las nuevas: `sshd` viene del product-rootfs y tampoco era
1410relanzable).
1411
1412#### Medido, con la VM arrancada UNA sola vez
1413
1414| | |
1415|---|---|
1416| la imagen trae | `/etc/arje/cards.d/{gitea,sshd}.json` |
1417| `arjectl list-units` | tabla con PID, CPU%, MEM, HILOS y reinicios de cada Ente |
1418| poner `/etc/gitea/app.ini` + `arjectl start gitea` | **`GET /` → 200**, sin reiniciar (`uptime` 6 min) |
1419| `arjectl restart gitea` | el PID cambia (118 → 192) y sigue sirviendo 200 |
1420
1421#### ⚠ `arjectl start` sobre un Ente YA VIVO lo DUPLICA
1422
1423`SpawnCardFromDisk` no deduplica por label: encarna otra instancia y arje le da un ULID nuevo. En
1424`gitea` el síntoma fue `unable to lock level db … resource temporarily unavailable` seguido de `[F]`
1425— dos servidores peleando por el mismo estado, con el HTTP intermitente mientras duraba. **Para
1426relanzar se usa `restart`**, o se mira `list-units` antes. Un `start` idempotente es trabajo de arje,
1427no de esta imagen; queda anotado río arriba.
1428
1429### 6.13 🧪 Ensayo con los DATOS REALES de gioser — el gitea de la caja vieja corriendo en takana
1430
1431Sin tocar gioser (todo lectura) y en la VM desechable. Es el ensayo que faltaba antes de cualquier
1432cutover, y trajo cuatro cosas que no se ven en el papel.
1433
1434**El snapshot de la DB se saca en caliente y sale consistente.** `sqlite3 gitea.db ".backup …"` con
1435el servidor VIVO: **1,5 s para 314 M**, `pragma integrity_check` → `ok`, 44 filas en `repository`.
1436Copiar el fichero a pelo con el servidor escribiendo es lo que NO hay que hacer; la API de backup de
1437sqlite existe justo para esto.
1438
1439**Resultado, medido dentro de la VM:** `<title>GioSer Gitea: Git with a cup of tea</title>`, 200, y
1440`/explore/repos` listando los repos de verdad (`sergio/takana`, `tawasuyu/agora`, `card`, `chasqui`,
1441`cosmos`, `khipu`, `llimphi`…). Y el clon de uno de los repos copiados: **478 commits**, HEAD
1442correcto, ficheros reales.
1443
1444#### Los tres detalles que sólo aparecen con los datos puestos
1445
14461. **El uid del origen no es el del destino.** Los ficheros llegan con su uid NUMÉRICO (`1001` en el
1447   rsync de prueba; el gitea de gioser es **969**) y el `[[user]]` declaraba 916. O se chownean 2 G
1448   —lento, y hay que acordarse— o gitea no puede leer sus datos, **y eso no falla al copiar: falla
1449   al arrancar**. La receta pasa a declarar **969**, alineado con el origen.
14502. **El `app.ini` de gioser escucha en `127.0.0.1:3002`**, porque allá caddy hace de proxy. Copiado
1451   tal cual, la caja sirve — pero sólo desde dentro. El `HTTP_ADDR`/`HTTP_PORT` y el `ROOT_URL` son
1452   parte de la adaptación, no del copiado.
14533. 🧨 **El `git` de la distro NO puede clonar por HTTP.** `git clone http://…` dentro de la imagen:
1454
1455       git: 'remote-http' is not a git command. See 'git --help'.
1456       fatal: remote helper 'http' aborted session
1457
1458   Medido sobre el ARTEFACTO sellado: `/usr/libexec/git-core/` trae `git-remote-ext`, `git-remote-fd`
1459   y `git-http-backend` (el lado SERVIDOR), y **no** `git-remote-http`/`-https`; `strings` del binario
1460   da **0** referencias a libcurl, pese a que `curl` está en `[deps] build`. Nadie lo había notado
1461   porque en el hub el `git` que se usa es el de Artix, no el sellado. Es
1462   [[subcomando-sin-driver]] otra vez: instalado, con contenido, reproducible… y sin el camino que
1463   hace falta. **Un hub nuevo no podría clonar el repo por HTTPS.** Arreglarlo re-sella `git`, que es
1464   raíz de `perfil.base` ⇒ unidad propia, no de paso.
1465
1466### 6.14 ✅ CUTOVER DEL GITEA — sirve desde la caja, con TLS y por SSH *(2026-09-14)*
1467
1468**Hecho y verificado desde fuera:** `git.gioser.net` y `git.tawasuyu.net` responden **200 con TLS
1469válido desde `2.29.29.217`**, `git clone` funciona **por HTTPS y por SSH:2345**, y `gitea` y `caddy`
1470corren supervisados por `arje-zero` en la caja. El gitea de gioser está **parado**.
1471
1472**Mudanza incremental, no big-bang.** Los DNS de gioser son casi todos `CNAME → www`, así que mover
1473`www` habría mudado quince dominios cuyos backends siguen allá: 502 en todos. Se convirtió sólo
1474`git` (en las dos zonas) de CNAME a **A propio con TTL 60**, que es reversible en un minuto.
1475
1476#### La secuencia que funcionó, en orden
1477
14781. Caja actualizada: `arjectl` + `gitea` + la cuenta `gitea:969` + las cards en `genesis` y `cards.d`.
14792. Datos en dos fases: **1,66 GB / 18 047 ficheros** con el origen VIVO (17 s), y en el corte el
1480   `rsync --delete` incremental + `sqlite3 ".backup"` (`integrity_check ok`).
14813. **Parar el origen de verdad.** `rc-service gitea stop` dice *«already stopped»* con el proceso
1482   vivo (el `rc-status` que miente, §Los tres hechos), y matarlo **no alcanza**: lo revive
1483   `arje-zero`, que lo tiene como card `openrc-gitea` con `Restart` — **9001 reinicios** acumulados
1484   en el contador. Se paró con **`arjectl stop openrc-gitea`**, y para eso hubo que extraer su card
1485   del `genesis` y escribirla en `/etc/arje/cards.d/` (§6.12: `SpawnCardFromDisk`/`StopCardFromDisk`
1486   leen de ahí, no del genesis).
14874. DNS por la **API de Hetzner Cloud** (`/v1/zones`): el token de `hcloud` **también gestiona el
1488   DNS** desde la unificación — la API vieja `dns.hetzner.com/api/v1` redirige a la consola. Y un
1489   `PUT` sobre el rrset **no puede cambiar el tipo**: hay que `DELETE` del CNAME y `POST` del A.
14905. TLS: el primer intento de ACME **falló contra gioser** (`502`) porque el challenge salió antes de
1491   que propagara; con el DNS ya al día, `arjectl restart caddy` y *certificate obtained successfully*.
1492
1493#### La identidad SSH se muda con el servicio
1494
1495`git clone ssh://…:2345` daba **`REMOTE HOST IDENTIFICATION HAS CHANGED`**: es otra máquina. Se
1496copiaron las **claves de host** de gioser (`/etc/ssh/ssh_host_*`) a la caja ⇒ los clones existentes
1497no notan nada. El precio es que cambia también la identidad del `:22` de administración, y hay que
1498limpiar el `known_hosts` propio — a los clientes del servicio no les afecta, que es lo que importa.
1499
1500Y el `sshd` del producto escucha sólo en `:22`: el git por SSH necesitó `Port 2345` y que el usuario
1501`gitea` tenga **shell real** (su `authorized_keys` fuerza `command="gitea serv …"`, y con
1502`/bin/false` no se ejecuta nada).
1503
1504#### Lo que esto cambia para la granja
1505
1506Las 23 recetas que ahora clonan por `https://git.tawasuyu.net/…` **apuntan a la caja**. Comprobado
1507tras el cambio: el worker resuelve `2.29.29.217` y `git ls-remote` responde. La granja depende ya
1508del servidor nuevo, que es el sentido de la mudanza.
1509
1510#### Cómo se revierte, si hiciera falta
1511
1512`arjectl start openrc-gitea` en gioser y devolver los dos `git` a `CNAME → www`. Con TTL 60, minutos.
1513
1514### 6.15 Cerrar el intermedio: el viejo apagado de verdad, el `:22` cerrado y los datos respaldados
1515
1516#### ⚠ El gitea viejo había VUELTO a arrancar — y lo arrancó OTRO supervisor
1517
1518Media hora después del corte, gioser volvía a servir en `:3002`. `arjectl list-units` **ya no lo
1519mostraba** (el `stop` de arje seguía en pie) y el proceso tenía **`ppid ≠ 1`**: lo había levantado
1520**OpenRC**, que lo tenía en el runlevel `default`. O sea **dos supervisores para el mismo servicio**
1521—la card `openrc-gitea` de arje y el runlevel de OpenRC— y parar uno no para el otro.
1522
1523    rc-update del gitea default   # que no vuelva
1524    rc-service gitea stop         # ahora sí: OpenRC lo arrancó, OpenRC sabe pararlo
1525
1526Antes del corte pasaba lo contrario (`rc-service … stop` decía *«already stopped»* con el proceso
1527vivo, porque quien lo tenía era arje). **La pregunta no es «¿está parado?» sino «¿quién lo tiene?»**,
1528y hay que responderla dos veces.
1529
1530#### El origen deja de servir git, y se comprueba que no se rompió lo demás
1531
1532Los tres bloques (`git.gioser.net`, `git.tawasuyu.net`, `gitea.gioser.net`) salen del Caddyfile de
1533gioser —con respaldo previo, `caddy validate` y `reload`—, y quedan 16. Control inmediato:
1534`sergio.gioser.net` y `hifas.gioser.net` siguen en **200**. `gitea.gioser.net` pasa a `A` → la caja,
1535donde ya está su `redir`.
1536
1537#### El `:22` cerrado, sin perder el acceso
1538
1539Administración en **22022**, git por SSH en **2345**, y el **22 cerrado** (`Connection refused`) para
1540sacarse de encima el barrido de bots. La secuencia importa y es la única segura: **añadir** el puerto
1541nuevo → reiniciar → **entrar por él** → sólo entonces quitar el 22. Comprobado en ese orden, y el
1542`git clone ssh://…:2345` sigue funcionando después.
1543
1544#### 🧨 Los datos del gitea NUNCA estuvieron respaldados
1545
1546`respaldo-storagebox.sh` respalda el **store de artefactos**, no `/var/lib/gitea`. O sea que los 44
1547repos vivían en una sola copia — en gioser antes, en la caja ahora. La mudanza no lo empeoró, pero sí
1548lo hace urgente: **gioser se borra**. Hecho hoy desde la caja: snapshot de la DB con el servicio vivo
1549+ `rsync` a `u647150:gitea/` — **1,7 G** (`datos/` + `gitea.db` de 314 M).
1550
1551⚠ **Al Storage Box se entra por el puerto 23**, no el 22: el 22 da SFTP/SCP restringido y contesta
1552`Permission denied (publickey,password)`, que se lee como *«no tengo la clave»* cuando la clave está
1553perfecta. Pasó en las dos máquinas antes de mirar el script (`SB_PORT=23`).
1554
1555**Pendiente**: que ese respaldo sea periódico, no de una vez. Es un renglón en el cron de la caja.
1556
1557### 6.16 ⚠ SÍ se perdieron dos commits en la ventana — y cómo se detectó
1558
1559La pregunta correcta después de un cutover no es «¿arrancó?» sino **«¿entró algo en el viejo
1560mientras tanto?»**. Se contesta comparando **todos los refs de los dos lados**:
1561
1562```sh
1563for r in <repos>/*/*.git; do git -C "$r" for-each-ref --format="$r %(refname) %(objectname)"; done | sort
1564```
1565
1566845 refs a cada lado, y **dos diferencias**. Una era esperada (`sergio/takana` main, el nuevo por
1567delante con los commits posteriores al corte — `merge-base --is-ancestor` confirma fast-forward). La
1568otra **no**: `tawasuyu/tawasuyu` tenía en el VIEJO dos commits que el nuevo no tenía —
1569`b69008eb` (freebsd) y `02a9535f` (shuma, **19:48**)—, o sea **quince minutos después del snapshot
1570final**.
1571
1572**Por qué entraron**: el gitea viejo había resucitado (§6.15, OpenRC) y un cliente con el DNS
1573**cacheado** —el CNAME anterior tenía TTL 600— lo empujó a gioser aunque el autoritativo ya dijera
1574la caja. Las dos condiciones a la vez: un origen que revive y una caché que todavía apunta.
1575
1576**Recuperados** con un `git push` del ref exacto desde el clon local al gitea nuevo; la UI del nuevo
1577ya muestra `02a9535f`. Segunda pasada de comparación: **845/845 y una sola diferencia, la esperada**.
1578Y del lado de los metadatos, `action` tenía tres filas posteriores al snapshot (los mismos dos
1579repos) y **cero** issues, comentarios o releases: no se perdió nada que no fueran esos commits.
1580
1581**La lección para el resto de la mudanza**, en orden: (1) bajar el TTL **antes** del corte, no
1582durante; (2) apagar el origen de verdad —los DOS supervisores— **antes** de tocar el DNS; (3)
1583comparar refs después, siempre, porque es la única prueba de que no se perdió nada; y (4) dejar el
1584origen apagado un rato **antes** de borrarlo, precisamente para poder hacer esta comparación.
1585
1586### 6.17 ⚠ En gioser conviven arje Y OpenRC — y el prefijo `openrc-` de las cards ENGAÑA
1587
1588El usuario avisó: *«esa máquina la tengo con arje desde hace meses»*. Tiene razón, **y las dos cosas
1589son ciertas a la vez**:
1590
1591| medido | |
1592|---|---|
1593| PID 1 | **`arje-zero`** ✓ |
1594| la card `openrc-gitea` | ejecuta `sh -c "cd /var/lib/gitea && exec /usr/bin/gitea web …"` — **no llama a OpenRC** |
1595| `/run/openrc/started/` | **existe y tiene servicios**: NetworkManager, dbus, dhcpcd, fsck, hostname, hwclock, local, localmount… |
1596| `rc-update show default` | listaba `gitea` |
1597
1598⇒ **El prefijo `openrc-` es herencia del NOMBRE**, de cuando `arje-absorb` tradujo los servicios de
1599OpenRC a cards: la card no pasa por `rc-service`, encarna el binario directo. Pero **OpenRC quedó
1600como residuo ACTIVO** y puede arrancar servicios por su cuenta — que es lo que revivió al gitea con
1601`ppid ≠ 1` después de que arje lo hubiera detenido.
1602
1603**La regla para el resto de la mudanza**: antes de dar un servicio de gioser por apagado, preguntar a
1604los **dos**:
1605
1606```sh
1607arjectl list-units | grep <svc>          # la capa de arje (PID 1)
1608rc-update show default | grep <svc>      # el residuo de OpenRC, que también arranca
1609```
1610
1611Es [[la-etiqueta-no-es-el-hecho]] en su forma más cara: un nombre que dice `openrc-` y no es OpenRC,
1612junto a un OpenRC real que nadie esperaba que siguiera operando.
1613
1614### 6.18 Mudados `takana.gioser.net` y `hifas.gioser.net` *(estáticos puros)*
1615
1616Los dos son ficheros y nada más —sin backend—, así que mudarlos fue copiar 52 K, añadir su vhost al
1617Caddyfile de la caja, mover el DNS de CNAME a **A** y quitarlos del origen. **200 con TLS válido
1618desde `2.29.29.217`**, y control de que no se rompió lo demás: `sergio.gioser.net` sigue en 200 y
1619gioser baja de 16 a **14 vhosts**.
1620
1621Se repitió el patrón de ACME: el primer intento de certificado sale ANTES de que propague el DNS,
1622falla contra el origen y hay que forzar el reintento con `arjectl restart caddy`. **Conviene mover
1623el DNS y recién entonces añadir el vhost** — o asumir un `restart` de más.
1624
1625**Quedan en gioser 14 vhosts**, todos con backend propio (uvicorn, php-fpm, `tejido`, `shuma`…) o
1626fósiles sin DNS. Ésos no se mudan copiando un directorio: necesitan su servicio del otro lado.
1627
1628### 6.19 Los fósiles, barridos: de 19 vhosts a **2**
1629
1630Se midió cada dominio que quedaba —DNS por DoH **y** HTTP contra la IP del origen— antes de tocar
1631nada. El resultado deja la mudanza mucho más chica de lo que parecía:
1632
1633| clase | cuántos | qué son |
1634|---|---|---|
1635| **fósiles sin DNS** | 5 | `aura`, `api.aura`, `sigma`, `kosmofono`, `api.kosmofono` |
1636| **ya viven en OTRA máquina** | 3 | `summa`, `dev.summa`, `api.dev.summa` → `154.197.1.2` |
1637| **502 permanente** | 2 | `mail.sigma` (:9000 caído), `api.gioser.net` (:8000 caído) |
1638| **mudados hoy** | 5 | los tres de git + `takana` + `hifas` |
1639| **VIVOS y por mudar** | **2** | `sergio.gioser.net` y `api.sergio.gioser.net` |
1640
1641**Y ninguna de las raíces estáticas de los fósiles existe en disco**: `/var/www/{aura_frontend,
1642sigma,kosmofono,summa,summa-dev}` no están. El Caddyfile servía directorios ausentes — la
1643configuración sobrevivió a sus datos. De los backends, sólo `:8770` sigue escuchando, y su dominio
1644ya apunta a otra máquina; `:8766 :8765 :9000 :8000 :8768` están caídos.
1645
1646Los 10 bloques muertos salen del Caddyfile (con respaldo previo, `validate` y `reload`), y el control
1647confirma que los vivos siguen: `sergio` y `api.sergio` en **200**, y los mudados respondiendo desde
1648la caja. **gioser pasa de 19 vhosts a 2.**
1649
1650⚠ **El único fósil CON datos es `terapeuta.ec`: 279 M en `/var/www/terapeuta`**, sin DNS y sin vhost.
1651No se borra acá — se anota para la decisión de borrado de la máquina, que es del §6.
1652
1653**Lo que esto cambia**: mudar los dos que quedan es un frente acotado —un backend Python en `:7378`
1654y una API en `:8771`— y no las quince cosas que la lista sugería.
1655
1656### 6.20 🛟 Cinco binarios rescatados de la nada — el paso que CADUCABA
1657
1658Antes de tocar `sergio.gioser.net` apareció lo urgente: **cinco procesos vivos cuyo binario YA NO
1659EXISTE en disco** (`/proc/<pid>/exe` → `… (deleted)`). Sólo existían como inode huérfano: si el
1660proceso muere o la máquina se reinicia, se pierden. Es el paso que el SDD 29 §4.0 undecies llamó *«el
1661que caduca»*, y caducaba de verdad.
1662
1663    tejido · sandokan-mcp · pacha-secretos · puerta-f6e393ffbef3999e · shuma-gateway   (240 M)
1664
1665Se recuperaron leyendo `/proc/<pid>/exe` con el proceso vivo, y ya están **fuera de gioser**: en
1666`/work/rescate-binarios/` de la caja **y** en `rescate-binarios/` del Storage Box. Cinco de los trece
1667binarios que nadie provee dejaron de depender de que nadie reinicie nada.
1668
1669### 6.21 🧱 `sergio.gioser.net`: el muro no es el sitio, es **glibc**
1670
1671El sitio son tres piezas, y sólo una se puede mudar hoy:
1672
1673| pieza | qué es | mudable a takana |
1674|---|---|---|
1675| el frontend | **117 M** de estático (`dist/`) | ✅ copiado ya a `/work/www/sergioh` |
1676| `/shuma/*` | `shuma-gateway` en `:7378` — **ELF dinámico, y su binario estaba BORRADO** | ⚠ hay que construirlo desde tawasuyu (es Rust del monorepo) |
1677| `api.sergio` | **uvicorn** con un venv de **405 M** | 🧱 **no, hoy no** |
1678
1679El backend es `fastapi + uvicorn + pydantic + google-generativeai + **langchain**`, con extensiones
1680compiladas `…cpython-314-x86_64-linux-**gnu**.so` — o sea **glibc**. Reempaquetar ese árbol de PyPI
1681como recetas no es realista, y correrlo en musl no es posible. **Es el caso de uso canónico del
1682[ADR 0015](adr/0015-imagenes-ajenas.md) (`qorpa`: imágenes ajenas glibc enjauladas)**, que está
1683PROPUESTO y sin implementar del todo.
1684
1685⇒ **El DNS de `sergio` NO se movió**: mover el nombre sin el backend deja el sitio servido y la
1686consola rota. El frontend queda copiado y esperando; el corte se hace cuando exista el camino para
1687las otras dos piezas.
1688
1689**Esto es lo que decide la fecha de borrado de gioser**: no es «mudar dominios», es que **un
1690servicio vivo no tiene hoy camino a takana**. Las salidas son tres y hay que elegir: (1) `qorpa`, que
1691es para exactamente esto; (2) que ese servicio viva en otra máquina —`summa` ya lo hace, y su DNS lo
1692demuestra—; o (3) que muera. Ninguna es técnica: es una decisión.
1693
1694### 6.22 🧨 El `curl` de la distro NO PUEDE VALIDAR TLS — y por eso nada se baja por HTTPS
1695
1696Al ir a traer la primera imagen ajena (`qorpa pull`), la caja falló con `curl failed to verify the
1697legitimacy of the server`. El certificado del servidor estaba bien; lo que falta es de este lado:
1698
1699```
1700* CApath: /etc/ssl/certs
1701* SSL certificate ... unable to get local issuer certificate (20)
1702$ curl --cacert /etc/ssl/certs/ca-certificates.crt ...   → 200
1703```
1704
1705El `curl` del corpus está compilado **con `--with-ca-path=/etc/ssl/certs` y sin CAfile**, y ese
1706directorio contiene **un solo fichero**: el bundle. Un *capath* necesita **hash-links**
1707(`c_rehash`) — el índice — y no los hay. Los certificados están, el índice no.
1708
1709**Por qué faltan**: `recipes/ca-certificates.toml` deja escrito el hook
1710`/etc/ca-certificates/update.d/certhash`, que en Alpine ejecuta `apk` al instalar. **En takana no lo
1711ejecuta nadie**: la distro proyecta artefactos, no corre post-install. Es la misma familia que
1712[[subcomando-sin-driver]] — todo presente, y el paso que lo conecta no existe.
1713
1714**Alcance**: no es sólo `qorpa pull`. Es `takana install --repo https://…`, el mirror, y cualquier
1715`curl`/`wget` de un script en una caja instalada. **No falla al construir ni al instalar: falla la
1716primera vez que la máquina intenta bajar algo.** Nadie lo había visto porque el hub usa el `curl` de
1717Artix.
1718
1719**Arreglado en la receta**: los hash-links se generan **en el build** —donde `c_rehash` y perl ya
1720existen— y viajan dentro del artefacto, con una guarda que **falla ruidosamente si el rehash no
1721produce ninguno**. Re-sella `ca-certificates`, que es raíz de `perfil.base`.
1722
1723**Apaño mientras tanto**, para invocaciones puntuales: `CURL_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt`
1724(comprobado: 200).
1725
1726### 6.23 `qorpa` en la caja: preflight en verde, y el segundo muro es `tar`
1727
1728Con el backend de `sergio` sin camino a musl (§6.21), la salida elegida es **qorpa**. Estado medido
1729en la caja:
1730
1731| paso | resultado |
1732|---|---|
1733| userns anidado · overlayfs sin privilegios | ✅ ya estaban |
1734| **disco** | ❌→✅ `/var/lib/hammer` vive en la raíz (3 G) ⇒ `qorpa` **se movió a `/work`** (62 G) por symlink |
1735| `subuid`/`subgid` | ❌→✅ rango escrito para root |
1736| `newuidmap`/`newgidmap` sin capability | ❌→✅ `setcap` aplicado — **y el artefacto del store NO se tocó** (inodes distintos: en una caja instalada esos binarios son copias, no hardlinks) |
1737| veredicto del preflight | **de «BLOQUEA 1 · LIMITA 4» a «LIMITA 1»** |
1738| `qorpa pull` de Arch bootstrap | baja y **verifica el sha256**, y falla al desempacar |
1739
1740El segundo muro: el rootfs de Arch es `.tar.zst` y **el `tar` de la imagen es el de busybox**, que no
1741lo entiende — el mismo tropiezo que ya costó el lab (`tar: unrecognized option: zstd`). `zstd` SÍ
1742está instalado. ⇒ `qorpa pull` tiene que descomprimir con `zstd -dc | tar -x` cuando el archivo es
1743`.zst`, en vez de dárselo entero a `tar`. Es un arreglo pequeño en el CLI, y hasta entonces la
1744alternativa es una imagen `.tar.gz` (Ubuntu base) — que además obliga a reinstalar las deps del venv,
1745porque el de gioser trae extensiones de **CPython 3.14** y Ubuntu 24.04 lleva 3.12.
1746
1747### 6.24 El TLS arreglado, la distro con nombre, y **por qué `upgrade` se quedaba sin espacio**
1748
1749**El `curl` ya valida.** Con `ca-certificates` re-sellado —**119 hash-links en el capath**, generados
1750en el build— la caja baja por HTTPS **sin ningún apaño**: `curl -I https://…` → **200**. El arreglo
1751tardó tres intentos y los dos primeros los cazó la guarda que puse en la propia receta: primero
1752`c_rehash` no estaba en el `PATH` (lo instala esa misma receta en `/out/usr/bin`), y después los
1753certificados **no estaban sueltos** en `usr/share/ca-certificates/` sino en su subdirectorio
1754`mozilla/`, así que `c_rehash` sólo veía el bundle y lo saltaba —correctamente— con «does not
1755contain exactly one certificate». Sin la guarda, las tres veces habría sellado un capath vacío.
1756
1757**`fastfetch` (2.68.1) corre en la caja** — y al correrlo apareció otra ausencia:
1758
1759```
1760OS: takana x86_64          ← ahora
1761Host: vServer (20171111)
1762Kernel: Linux 7.1.2 · CPU: AMD EPYC-Rome (4) · Memory: 393 MiB / 7.58 GiB
1763```
1764
1765…porque **`/etc/os-release` NO EXISTÍA**. La distro era anónima para cualquier programa que no fuera
1766suyo. Se resolvió con una receta propia (`os-release`, `source.dir`) en vez de una constante en
1767`takana-bootstrap`: meterlo ahí re-sellaría el `product-rootfs` —el baseline del selfhost— por cinco
1768líneas. Sin `VERSION_ID` ni fecha a propósito: un sello con la fecha del build cambiaría el hash del
1769artefacto, y con él la clausura de toda imagen que lo lleve, cada día y sin motivo.
1770
1771#### 🧨 `/var/lib/hammer` es una partición de 487 MB — y ahí viven las generaciones
1772
1773`upgrade apply` falló dos veces con `No space left on device` teniendo **3 G libres en la raíz**. Ni
1774el espacio de `/` ni los inodos (9% usados): el estado de generaciones vive en
1775**`/var/lib/hammer`, que es `sda3` y mide 487 MB** (la partición «estado» del layout). Cada
1776generación guarda una copia del árbol aplicado — el nuestro son **272 MB** — así que **dos no caben**.
1777
1778⇒ El estado se movió a `/work` por symlink, igual que `qorpa`. Tras eso: `✓ generación 6 aplicada`.
1779**El layout de la imagen necesita revisión**: 512 MB de «estado» no alcanzan para un mecanismo que
1780guarda un árbol entero por generación, y el síntoma (`ENOSPC` con la raíz medio vacía) apunta al
1781sitio equivocado.
1782
1783### 6.25 ✅ CUTOVER DE `api.sergio.gioser.net` — el primer servicio AJENO que sirve takana *(2026-09-15)*
1784
1785**`https://api.sergio.gioser.net` responde 200 con certificado público válido desde `2.29.29.217`**,
1786y su `/api/chat/` contesta con Gemini de verdad. El backend corre **dentro de una jaula `qorpa`**
1787(rootfs de Arch pineado por sha256), supervisado por `arje-zero` como el ente `sergioh-api`.
1788
1789Es el servicio que §6.21 declaró sin camino a musl —su venv trae extensiones
1790`cpython-314-x86_64-linux-**gnu**.so`— y por eso «lo que decide la fecha de borrado de gioser». El
1791camino elegido era `qorpa` (ADR 0015) y ahora está recorrido de punta a punta.
1792
1793**La coincidencia que lo hizo barato:** el Arch bootstrap pineado trae **python 3.14.7** y el venv de
1794gioser es **3.14.6**. Misma serie ⇒ las extensiones compiladas no son un problema: el venv se rehace
1795adentro con `pip`, no se copia.
1796
1797#### 🧨 EL MURO: la jaula no viajaba en NINGUNA imagen
1798
1799`takana qorpa provision` abortó con un mensaje correcto y una instrucción imposible:
1800
1801    Error: no encuentro harkaq-exec en /root/.cache/harkaq/harkaq-exec
1802      construilo:  gcc -O1 -Wall -static -o … scripts/harkaq/harkaq-exec.c
1803
1804**En una caja instalada no hay `gcc`, ni `scripts/`, ni árbol de desarrollo.** El binario sólo existía
1805como un `gcc` a mano en la caché de `$HOME` del hub — o sea que la jaula del ADR 0015 funcionaba
1806**únicamente en la máquina donde alguien la había compilado**. Y su compañero estaba igual, medido en
1807`build-state.json`: **`bwrap` sellado desde hace meses con `"perfiles": []`**, CERO perfiles. Los dos
1808se invocan por PATH, y no sólo desde `qorpa`: `takana-build/src/sandbox.rs` llama a `bwrap` en cada
1809build. ⇒ **ninguna imagen de takana podía enjaular nada, ni construir**. Es
1810[[subcomando-sin-driver]] un piso más abajo: el CLI que los llama viaja en todas las imágenes y sus
1811herramientas en ninguna.
1812
1813Arreglado en la misma unidad de trabajo: `recipes/harkaq-exec.toml` (nueva, estática musl,
1814`b3:cd34954f…`, 269 K), `bwrap` + `harkaq-exec` declarados en **`perfil.base`**, y `qorpa.rs`
1815buscando el binario también en `/usr/bin` —el orden es `HARKAQ_BIN` → árbol de desarrollo → paquete,
1816para que un cambio en la jaula se pruebe sin instalar nada—. ⚠ El pin de la receta va **al commit que
1817tocó la fuente** (`1d9ddcee`, del 2026-09-03) y no a HEAD: el repo commitea cada media hora por el
1818cron de la cosecha, y pinear HEAD re-hashearía la receta cada media hora sin que su fuente se moviera.
1819
1820#### Los tres tropiezos del camino, todos de la misma familia
1821
18221. **`chown`**: el `rsync` preservó el uid 1001 de gioser, y dentro del userns ese uid queda FUERA del
1823   rango mapeado ⇒ ni siendo root adentro se puede escribir. `python -m venv` fallaba con
1824   `Permission denied` en el directorio concedido mientras andaba perfecto en `/tmp`. El árbol del
1825   sitio va a `root:root` del anfitrión, que es lo que el mapa de la jaula sí alcanza.
18262. **Una instancia, un `run`**: el segundo `qorpa run` sobre la misma instancia es rechazado por el
1827   kernel («dos overlays con el mismo `upper` corromperían la capa mutable»). Correcto y hay que
1828   saberlo: con el servicio arriba **no se entra a la instancia a hacer mantenimiento**.
18293. **`ps` de la caja no ve los procesos y `dig` no existe en el hub**. Dos herramientas ausentes que
1830   se leen como diagnóstico: el primero dice «no hay nada corriendo» y el segundo dejó un `until` de
1831   espera de DNS girando cinco minutos contra una condición que **nunca podía cumplirse**. Un
1832   guardián que no puede pasar nunca se ve igual que uno que todavía no pasó.
1833
1834#### Lo que quedó declarado, y lo que no
1835
1836- `instance.toml` es la verdad: `packages = ["python","python-pip"]`, `network = true` (pacman, pip y
1837  la propia API de Gemini la necesitan) y **un solo dir concedido** (`/work/sergioh` → `/srv/sergioh`,
1838  rw). Ni sockets, ni dispositivos, ni nada más.
1839- El código y el venv viven **fuera** de la instancia, en el anfitrión: el `upper` es caché (D3) y se
1840  tira. Y las 84 dependencias quedaron pineadas en `requirements.lock` — el `requirements.txt` del
1841  sitio no pinea nada, así que sin el lock un `recreate` traería otras versiones.
1842- La tarjeta `sergioh-api` va en `/etc/arje/cards.d/` **y** en el `genesis` de `/ente/seed.card.json`
1843  (son dos preguntas distintas: qué arranca solo y qué se puede encarnar a pedido, §6.12), con dos
1844  guardas que salen 78 nombrando el arreglo si falta la instancia o el venv.
1845- ⚠ **Todavía invoca con `HARKAQ_BIN=/usr/bin`** en la tarjeta: el `takana` de la caja es el del
1846  `commit` pineado en `recipes/takana.toml` y no trae aún la búsqueda en `/usr/bin`. Sale solo cuando
1847  se suba ese pin.
1848
1849#### El estado de la mudanza tras esto
1850
1851| | |
1852|---|---|
1853| **mudado hoy** | `api.sergio.gioser.net` (DNS: CNAME→`www` **borrado**, A→`2.29.29.217` TTL 60) |
1854| **pendiente inmediato** | apagar el `sergioh_backend` de gioser **cuando propague** (OpenRC *y* arje: `rc-update del` + `rc-service stop` + `arjectl stop openrc-…`, §6.17). Hasta entonces sirve a los resolutores que aún tengan el CNAME cacheado |
1855| **lo que falta de `sergio.gioser.net`** | el frontend ya está copiado en `/work/www/sergioh`; falta `/shuma/*` → `shuma-gateway` (:7378), que es glibc dinámico y **cabe en esta misma jaula** (el binario está rescatado en `/work/rescate-binarios/`) pero cuelga de `shuma-daemon`, que es un sistema entero, no un binario |
1856| **y los otros dos vivos** | `gioser.net`/`www` (estáticos + `/hooks/*` en :8770 + `/reencuentro` con php-fpm) y `tawasuyu.net` (estático, raíz en `/mnt/vvv/tawasuyu`) |
1857
1858### 6.26 ✅ `tawasuyu.net` y `gioser.net` MUDADOS — y el PHP que no existe en el corpus *(2026-09-15)*
1859
1860**Los dos sitios que quedaban con tráfico real sirven desde la caja `takana`**, con TLS público y
1861verificados desde fuera. Los servicios viejos **siguen corriendo en gioser a propósito** (decisión del
1862usuario: mudar el DNS y dejar el origen vivo, para poder volver en un minuto).
1863
1864| dominio | qué es | estado |
1865|---|---|---|
1866| `tawasuyu.net`, `www.` | landing + `/pkg` wasm + `/descargas` (3,8 G) | **200 desde 2.29.29.217** |
1867| `gioser.net`, `www.` | 5 raíces estáticas (428 M) + `/reencuentro` con PHP | **200 desde 2.29.29.217** |
1868| `sergio.gioser.net` | frontend + `/shuma/*` | **se queda en gioser**: su consola no tiene camino todavía |
1869
1870**`sergio` dejó de ser un `CNAME → www` y tiene su A propio** (apuntando a gioser, sin cambio
1871visible). Sin eso, mover `www` se lo habría llevado puesto — es la trampa del §6.14 vista a tiempo:
1872en esta zona **casi todo cuelga de `www`**. Lo que sí quedó colgando son tres fósiles (`api`,
1873`mail.sigma`, `monitor`): antes daban 502 desde gioser y ahora fallan el TLS contra la caja. Están
1874muertos hace meses; se anotan, no se mudan.
1875
1876**Dos cosas que el log de accesos decidió mejor que cualquier intuición:**
1877- La raíz de `tawasuyu.net` en gioser era **el monorepo entero (145 G) servido por HTTP**. El log
1878  dice que las únicas rutas con tráfico son `/`, `/descargas` y `/web` ⇒ se replicaron **sólo** los
1879  dos subárboles que el sitio usa (1,2 M + 3,8 G), con la MISMA estructura para que cada `rewrite`
1880  siga siendo el mismo.
1881- **`/hooks/*` NO se muda**: lo atiende `webhook-deploy.py`, que redespliega `aura_*`, `sigma_*`,
1882  `summa_*` y `brahman` — **los cuatro son fósiles del §6.19**, y tiene cero peticiones. Muere con la
1883  caja vieja. Un servicio vivo que sólo sirve a muertos es basura, no deuda.
1884
1885#### PHP: la segunda jaula, y por qué no entra al corpus
1886
1887`/reencuentro/` es una página con **un** `guardar.php`. PHP no está en el corpus y no tiene por qué
1888estar: lo sirve **`php-fpm 8.5.10` dentro de la instancia `gioser-php`** (ADR 0015), por
1889`127.0.0.1:9000`, supervisado por arje. Control contra el original, en los dos sentidos: `POST` con la
1890trampa anti-robots → `{"ok":true}` 200 igual que en gioser; `GET` → **405** igual que en gioser.
1891
1892⚠ **El webroot entra a la jaula EN LA MISMA RUTA** (`/work/www/gioser-web`): el `SCRIPT_FILENAME` de
1893FastCGI es una ruta absoluta del anfitrión, y si adentro viviera en otro sitio php-fpm contesta
1894«File not found» sin decir cuál. Y la config de php-fpm vive en el ANFITRIÓN
1895(`/work/etc/gioser-php/php-fpm.d/`) y entra por concesión: el `upper` de la instancia es caché y
1896`recreate` se la llevaría.
1897
1898#### 🧨 Los padres que inventa bwrap son **0700** — y eso deja la concesión fuera de alcance
1899
1900El muro real del día, y es general, no de PHP:
1901
1902    $ curl -X POST https://gioser.net/reencuentro/guardar.php
1903    File not found.          ← y el fichero ESTÁ, montado, con sus modos correctos
1904
1905Para montar en `/work/www/gioser-web`, bwrap tiene que crear `/work` y `/work/www` —que la imagen de
1906Arch no trae— y **los crea `drwx------ root`**. Adentro somos root, así que todo a mano funciona; pero
1907**un servicio que baja de privilegio** (php-fpm a `http`, o cualquier instancia con `run_as`) no puede
1908ni atravesarlos. Medido con el control que lo separa de una confusión de permisos del anfitrión: como
1909`http`, leer un fichero **de la imagen** funciona y leer el **directorio concedido** da
1910`Permission denied`.
1911
1912⇒ `grants_to_args` crea ahora los ancestros que faltan con `--perms 0755 --dir`, y **sólo los que la
1913imagen no trae**: hacerlo sobre `/etc` o `/home` le cambiaría los modos a la imagen. Con test que
1914falla a propósito si la condición se rompe (`left: ["/etc","/etc/php"]` contra `right: ["/etc/php"]`).
1915Misma familia que el `--perms 1777` que ya hacía falta antes del `--tmpfs /tmp`.
1916
1917⚠ La caja corre el `takana` del `commit` pineado en `recipes/takana.toml`, así que **allá el arreglo
1918todavía no está**: el camino se abrió a mano en el `upper` de la instancia (`chmod 755 /work
1919/work/www`). Es exactamente lo que el arreglo vuelve innecesario en el próximo `takana upgrade`.
1920
1921#### Y el estado de `rust` y de `claude`, que no es el que parece
1922
1923- **`rust` está en la caja pero no instalado**: `rust-toolchain-bin` está **sellado en el store** y
1924  declarado en `perfil.servidor`, y `rustc 1.97.0` corre invocándolo por su ruta del store — pero
1925  **no está en el `PATH`** porque la caja se instaló antes de esa declaración. Proyectarlo son 798 M
1926  sobre una raíz de **5,8 G con 2,9 G libres**: entra, pero el layout de la imagen (§6.24) merece la
1927  revisión primero.
1928- **`claude` no está mudado**, y es otro caso de jaula: el binario de gioser es **glibc dinámico**
1929  (`/lib64/ld-linux-x86-64.so.2`), o sea el mismo montón que el backend de `sergio`. Lo que pesa no
1930  es el binario sino su estado: **6,8 G de `~/.claude`**, de los cuales 5,3 G son `jobs` y 976 M
1931  `projects` — y ahí vive la memoria, **indexada POR RUTA del repo**. Mudarlo es una decisión sobre
1932  qué se lleva, no una copia.
1933
1934### 6.27 🧦 `squid` mudado — y la jaula que arrancaba DEGRADADA cuando la arranca un init *(2026-09-15)*
1935
1936**El proxy de salida sirve desde la caja**: `squid 7.7` en `2.29.29.217:1137`, con la config, el
1937`passwd` de los tres usuarios y las dos ACL de gioser tal cual, dentro de la instancia `squid` y
1938supervisado por arje. **El de gioser sigue vivo e intacto** (7.6), así que los clientes que apuntan
1939a la IP vieja no se enteraron.
1940
1941Es un servicio con gente encima: el `access.log` del origen mostraba `CONNECT api.anthropic.com` y
1942`CONNECT claude.ai` **en el minuto anterior a mudarlo**, desde IPs de Venezuela y con tres usuarios
1943autenticados. Por eso se mudó entero y sin reescribir nada.
1944
1945Control en los dos sentidos: desde una IP no autorizada, **407 Proxy Authentication Required**
1946—igual que el original—; desde `localhost`, que su propia config permite, **TCP_TUNNEL/200 a
1947claude.ai y a api.anthropic.com**.
1948
1949#### Los cuatro muros, y el cuarto es el que vale
1950
19511. **`provision` con la config ya montada aborta**: pacman dice «squid.conf.default exists in
1952   filesystem» porque el paquete quiere escribir sus defaults donde está la concesión. ⇒ provisionar
1953   **primero**, montar **después**. Queda escrito en el manifiesto.
19542. **`/dev/shm` lo crea bwrap 0755 root**, y squid —que baja a `proxy`— muere con
1955   `FATAL: shm_open(...): (13) Permission denied`. Un `chmod 1777` en el arranque.
19563. **El fichero de PID sobrevive entre corridas y SIEMPRE parece fresco**: cada `run` tiene su propio
1957   namespace de PIDs, así que el `/run/squid.pid` de la corrida anterior dice `PID 2`… y en la nueva
1958   hay un PID 2 vivo. Squid concluye «Squid is already running» y se niega. ⇒ `rm -f` en el arranque.
1959   Es una trampa general de cualquier servicio con pidfile dentro de una jaula con `--unshare-pid`.
19604. 🧨 **El rango de subuid se buscaba por `$USER` — y un init no lo pone.** Bajo arje la tarjeta
1961   arranca con `PATH` y `HOME` y poco más; el nombre salía **vacío**, no había rango, y la jaula caía
1962   al **userns de un solo id**. Squid moría en `setgid(15): (22) Invalid argument` y el supervisor lo
1963   reintentaba 80 veces. El aviso de qorpa era correcto y estaba impreso —«no hay rango para `""` en
1964   /etc/subuid»— pero **lo que se ve en el bucle es el error de squid, no el nuestro: la degradación
1965   silenciosa la paga el de más abajo**. Y el mismo comando a mano, desde una shell con `$USER`,
1966   funcionaba perfecto: *el síntoma dependía de quién lo arrancaba*.
1967   ⇒ `nombre_de_usuario()` deriva el nombre del **uid real** leyendo `/etc/passwd`, y el entorno pasa
1968   a ser el último recurso. El uid es el hecho; `$USER` es una etiqueta ([[la-etiqueta-no-es-el-hecho]]).
1969   Las tarjetas llevan además `USER`/`LOGNAME` explícitos, que era el arreglo del día.
1970
1971⚠ **`arjectl start` sobre un Ente ya vivo lo DUPLICA** (se vio con `gioser-php`: dos entes, uno
1972peleando por el mismo `upper`). Y matar el proceso de adentro **no libera la instancia**: el
1973`takana qorpa run` de afuera sigue vivo y el siguiente `run` choca. Para relanzar, `stop` y después
1974`start`, mirando `status` en el medio.
1975
1976#### Y la pregunta que corresponde: ¿no va en una receta?
1977
1978**Sí, y sigue pendiente.** El propio §6.2 pone a `squid` en la lista de recetas que esta mudanza
1979tiene que producir. Lo de hoy fue la vía URGENTE —el servicio estaba en uso y la jaula lo levanta en
1980minutos, sin compilar nada—, no la respuesta final. La diferencia con `php-fpm` importa:
1981**PHP no queremos que entre al corpus** (es un intérprete ajeno al proyecto, y la jaula es su lugar
1982definitivo), mientras que **`squid` es C, se compila con el lab y su sitio natural es una receta**
1983como la de `gitea`. Cuando esté, la instancia se tira: el manifiesto es descartable a propósito.
1984
1985### 6.28 📦 `squid` YA NO ESTÁ ENJAULADO: corre desde el corpus *(2026-09-15)*
1986
1987La jaula del §6.27 duró unas horas, que es lo que tenía que durar. **Hoy el proxy de producción es
1988el artefacto sellado `b3:932ba096…`**, proyectado en la caja y arrancado por arje sin bwrap de por
1989medio: `pid 11548 · uid=968 · exe=/usr/sbin/squid`. La instancia `qorpa/squid` se borró — el
1990manifiesto es descartable por diseño (D3) y esto es exactamente para lo que existía esa salida.
1991
1992`recipes/squid.toml`: 7.7, estático de verdad (binario **y** los cuatro helpers), `[[user]] proxy`
1993con uid 968 y `[[service]]` del SDD 30. Declarado en `perfil.servidor` como paquete y en `servicios`.
1994
1995**La config NO viaja en el paquete y es a propósito**: `squid.conf`, el `passwd` de los tres usuarios
1996y las dos ACL (412 K, 40 IPs autorizadas) son datos del SITIO. El servicio los comprueba al arrancar
1997y sale **78 nombrando cuál falta**, en vez de dejar un bucle de reinicios.
1998
1999#### Los tres muros de la receta, en orden
2000
20011. **La URL de upstream devolvía una página HTML de 8985 bytes con un 200.**
2002   `squid-cache.org/Versions/v7/squid-7.7.tar.xz` no es el tarball. Pinear su sha256 habría anclado
2003   la receta a una página de error — y habría «funcionado» hasta el primer build. Va el release de
2004   GitHub, que además trae `configure` generado.
20052. 🧨 **`--export-dynamic` desactivaba el enlace estático, y el binario sellaba igual.** El primer
2006   artefacto tenía `usr/sbin/squid` **dinámico con `NEEDED libc.so`** mientras sus helpers salían
2007   estáticos: inerte en cualquier imagen sin cargador ([[needed-colgante-libstdcxx]]) pese a
2008   `link = "static"`. La cadena tiene tres eslabones y ninguno es obvio: `squid_LDFLAGS` trae
2009   `-export-dynamic` (para módulos eCAP, apagados) → **el wrapper del lab quita `-static` de
2010   cualquier enlace que mencione `--export-dynamic`**, a propósito, para poder enlazar las `.so`
2011   dlopen-ables de Python → y **libtool vuelve a añadirlo solo** en cuanto hay un `-dlopen`, así que
2012   sacarlo de la variable no alcanza. Se vacía `export_dynamic_flag_spec` en el `libtool` GENERADO,
2013   con guarda que aborta si el campo no aparece: *un `sed` que no acierta deja pasar el problema y
2014   el binario sale dinámico sin que nada falle*.
2015   ⚠ Y `-dlopen force` **no sobra**: vaciar `squid_LDFLAGS` entero rompe el enlace con
2016   `undefined symbol: lt__PROGRAM__LTX_preloaded_symbols`, que emite el propio libtool porque hay un
2017   `-dlopen`. De los dos flags estorba uno; distinguirlos costó un build y adivinar cuesta lo mismo.
20183. **`--disable-log-daemon-helpers` compilaba perfecto y no arrancaba.** El default de `access_log`
2019   es `daemon:`, así que sin `log_file_daemon` squid muere con
2020   `FATAL: logfile_daemon /usr/lib/squid/log_file_daemon: (2) No such file or directory`. **Sólo se
2021   ve levantando el servicio con la config real; el sellado, el hash y el `-k parse` pasan los tres.**
2022   Es la familia de [[subcomando-sin-driver]] otra vez.
2023
2024#### El control que hay que correr antes de tocar producción
2025
2026Con la config REAL del origen, en el hub y en un puerto aparte: `-k parse` sin FATAL, arranque
2027completo, **`CONNECT claude.ai` y `CONNECT api.anthropic.com` con TCP_TUNNEL/200**, el `access.log`
2028escrito por el log daemon, y el `basic_ncsa_auth` leyendo el `passwd` de verdad (control negativo:
2029con una clave mala contesta `ERR Wrong password`). Los dos primeros intentos de esta receta habrían
2030llegado a producción sin ese control: el binario estaba sellado y el hash era estable las dos veces.
2031
2032### 6.29 ⏱️ La caja tiene HORA, LATIDO y ROTACIÓN — y el respaldo del gitea dejó de ser a mano *(2026-09-15)*
2033
2034`planear.py --revisar` sobre el censo del día ordena lo que queda, y lo primero de la lista no eran
2035los servicios del usuario sino **tres capacidades que ninguna métrica reclama**: el disparador
2036periódico, la hora y la rotación de logs. Los tres paquetes ya estaban sellados y declarados en
2037`perfil.servidor` desde que ese perfil nació — **lo que faltaba era el eslabón que los ARRANCA**.
2038
2039| | antes | ahora |
2040|---|---|---|
2041| `chronyd` | la caja iba **15 s atrasada** y nadie la corregía | stratum 3 contra `ntp{1,2,3}.hetzner.de`, **0,000005 s** de NTP |
2042| `crond` | no existía el latido | ejecuta el crontab real, verificado con una entrada `* * * * *` |
2043| `logrotate` | `/var/log/squid` sin rotar | diario con `squid -k rotate`, 14 copias |
2044| respaldo del gitea | **a mano, una vez** (§6.15) | `17 3 * * *`, con el snapshot consistente de la sqlite |
2045
2046**El respaldo, medido:** `scripts/respaldo-gitea.sh` sube **44 repos (23 `sergio` + 21 `tawasuyu`,
20471,5 G)** y un `gitea.db` de **332 M** tomado con `.backup` —consistente con el servidor vivo— al
2048Storage Box. El control no es que el script salga 0: es **contar los repos de los dos lados**, que
2049es lo que se hizo.
2050
2051⚠ **`chrony` y `cronie` NO declaraban `[[service]]`**, como `squid` antes: el paquete llegaba a la
2052imagen y no lo arrancaba nadie. Ahora lo declaran (fuera de `hash_inputs`: los hashes no se movieron)
2053y `perfil.servidor` los habilita en `servicios`.
2054
2055⚠ **La config va aparte y el servicio sale 78 si falta**, igual que gitea: a qué NTP se pregunta y
2056qué logs se guardan son decisiones del SITIO. Una caja que se sincroniza contra un pool que nadie
2057eligió es peor que una sin hora, porque nadie lo mira.
2058
2059#### Tres cosas medidas que valen más que el resultado
2060
20611. **La deriva era de gioser, no de la caja.** Antes de chrony la caja iba 15 s atrás; después, la
2062   caja quedó en hora de NTP y **el hub pasó a estar 3 s adelantado**. La máquina de referencia era
2063   la equivocada — medir «contra el otro» sin un tercero no dice quién está mal.
20642. **El spool de cronie es `/var/spool/cron/<usuario>`, no `…/crontabs/<usuario>`.** `crontab -l`
2065   mostraba las entradas y `crontabs/` estaba vacío. El día que alguien restaure un crontab a mano
2066   en el sitio equivocado va a tener un fichero perfecto que nadie lee. Lo decide un control y no la
2067   intuición: meter un `* * * * *` en el crontab REAL y ver si dispara.
20683. 🧨 **`sqlite3` seguía inerte en la caja** (`Error relocating: compressBound: symbol not found`):
2069   es el último de los 23 binarios del §6.4, y le faltaba `zlib-shared` — **sellado y declarado en
2070   `perfil.base` desde el 2026-09-11**, pero la caja se instaló antes. Sin él no había snapshot
2071   consistente, o sea que el respaldo habría copiado la sqlite a lo bruto. *Un paquete declarado no
2072   es un paquete instalado: en una caja viva, lo que vale es lo que el `upgrade` proyectó.*
2073
2074### 6.30 ⚰️ Tres servicios que MUEREN — y el cortafuegos que no puede correr todavía *(2026-09-15)*
2075
2076Decisión del usuario sobre lo que quedaba del censo, y las tres son «no se muda»:
2077
2078| servicio | por qué muere |
2079|---|---|
2080| **`qdrant`** (`:6333`, `:6334`) | es la base vectorial de `gioser_api`, y **ese backend es un fósil**: `api.gioser.net` da 502 permanente desde el §6.9. Una base sin consumidor no se muda. La receta `recipes/qdrant.toml` queda en el catálogo —**catálogo ≠ imagen**, y eso no es deuda—, pero no entra en ningún perfil. |
2081| **`act_runner`** (`:41027`) | el runner de CI del gitea, un binario suelto en `~/.local/bin` que nadie provee. Muere con la caja; si mañana hace falta CI, entra por receta y no por un binario copiado. |
2082| **`fail2ban-server`** | **tawasuyu ya tiene el sustituto**, y es mejor: `shared/cortafuegos` (§1 de su SDD-ENTRADA) no mira logs con un daemon, usa **dos sets dinámicos del kernel** (`ban4`/`ban6`, `flags dynamic`, `timeout`) con `limit rate over N/minute` **por IP de origen**. El ban lo aplica nftables sin proceso y sin latencia; fail2ban es un daemon de Python leyendo ficheros para hacer lo mismo peor. |
2083
2084#### 🧨 Pero el sustituto NO PUEDE CORRER: el kernel de la caja no trae `nf_tables`
2085
2086    $ nft list ruleset
2087    netlink: Error: cache initialization failed: Invalid argument
2088
2089`nft 1.1.6` **está instalado** (`nftables` es raíz de `perfil.servidor` y está sellado). Lo que falta
2090está un piso más abajo, en el `.config` que el artefacto publica:
2091
2092    CONFIG_NETFILTER=y          ← sí
2093    CONFIG_NF_CONNTRACK=y       ← sí
2094    # CONFIG_NF_TABLES is not set   ← AQUÍ
2095    # CONFIG_NETFILTER_ADVANCED is not set   ← y ésta es la causa: NF_TABLES cuelga de ella
2096
2097Es otra vez la lección del §6.4 muro 1: **la receta dice lo que se CAMBIÓ; sólo el `.config` sellado
2098dice lo que QUEDÓ**. `linux-generic` sale de un `make defconfig`, y defconfig deja `NETFILTER_ADVANCED`
2099apagado, que arrastra a `NF_TABLES` con él.
2100
2101⇒ **Hoy la caja no tiene cortafuegos de ninguna clase**: ni fail2ban (que no se muda), ni el
2102sustituto (que no arranca), ni una regla. Con `:22022`, `:2345`, `:1137`, `:80` y `:443` públicos,
2103eso hay que decirlo entero y no dejarlo implícito. La cura es un kernel con
2104`CONFIG_NETFILTER_ADVANCED=y` + `NF_TABLES` (y `NFT_CT`, `NFT_LIMIT`, `NFT_COUNTER`, `NFT_LOG`),
2105que es trabajo del SDD 22 y termina en un **reinicio de la caja de producción**.
2106
2107#### La mitigación que NO depende del kernel, hecha hoy
2108
2109El `sshd` de la caja ofrecía `password` y `keyboard-interactive` — su config eran **cuatro líneas**
2110y ninguna decía nada de autenticación, así que regía el default de OpenSSH. Sin cortafuegos y sin
2111fail2ban, eso es exactamente la puerta que aquéllos cerraban. Ahora es **sólo claves**, con los
2112cuatro controles corridos: la clave entra ✅, `:22022` contesta `Permission denied (publickey)` sin
2113ofrecer contraseña ✅, `:2345` igual ✅, y el `git ls-remote` por SSH sigue funcionando ✅.
2114
2115**Lo que enseña:** *una defensa que se muda tiene que mudarse con su capacidad, no con su nombre*.
2116Decidir «fail2ban muere porque tenemos algo mejor» es correcto **y** deja un hueco abierto hasta que
2117ese algo mejor pueda ejecutarse. Entre la decisión y la capacidad hay un kernel de por medio.
2118
2119### 6.31 ✅ La caja arrancó con `nf_tables` — y el init la levantó ENTERA sola *(2026-09-15)*
2120
2121    $ nft list ruleset
2122    $                       ← sin error: vacío, que es lo correcto en una caja sin reglas
2123
2124El kernel `b3:63fdd57c…` bootea, y con él **`nft` funciona por primera vez en una máquina takana**.
2125Comprobado con el mecanismo exacto que reemplaza a fail2ban, no con una regla de adorno: un
2126`set ... flags dynamic; timeout 10s` con `add @ban4 { ip saddr timeout 10s limit rate over 5/minute }
2127drop` — aceptado por el kernel (`rc=0`) y releído tal cual. Eso es el ban por IP **dentro del
2128kernel**, sin daemon.
2129
2130#### Lo que el reinicio probó de paso, y vale más que el kernel
2131
2132**La Semilla levantó los OCHO entes sola, todos con `↻ 0`:** `sshd`, `gitea`, `caddy`, `squid`,
2133`crond`, `chronyd`, `sergioh-api` y `gioser-php` — o sea los dos servicios enjaulados en `qorpa`
2134(con su `newuidmap`, su overlay y su `harkaq`) **arrancan desde el genesis igual que un binario
2135nativo**. Todo lo que se fue editando en `/ente/seed.card.json` a lo largo del día era, hasta este
2136momento, una declaración sin probar: un reinicio es el único examen que toma.
2137
2138Desde fuera, al minuto: los siete dominios en **200**, el proxy en **407** y `git ls-remote` por
2139SSH:2345 devolviendo el commit. Cero intervención.
2140
2141#### ⚠ `reboot` NO reinicia una caja con arje-zero
2142
2143`reboot` de busybox le pide a PID 1 que lo haga, y **arje-zero no implementa ese protocolo**: el
2144comando vuelve, no dice nada, y la máquina sigue arriba (`up 4 days` después de «reiniciar»). Lo que
2145sí funciona es **`reboot -f`**, que llama a `reboot(2)` directo saltándose al init. Con `sync` antes,
2146claro: el corte es duro por definición.
2147
2148⇒ **Y falta la pieza**: un init que gobierna un servidor de producción tiene que atender un apagado
2149ordenado. Hoy la única vía es el corte duro, que ya costó el `write_atomic` no durable del §6.13.
2150
2151#### 🧨 Casi reinicio el HUB por un backtick en un `echo`
2152
2153Escribiendo el aviso del reinicio, el mensaje decía ``… no atiende el `reboot` normal …`` dentro de
2154comillas DOBLES. La shell ejecutó lo que había entre backticks: **`reboot`, en gioser**. No pasó nada
2155por una razón que no es mérito de nadie —la sesión no es root y OpenRC contestó «you must be root»—
2156y el hub lleva 11 días arriba, con la granja y el cron encima.
2157
2158Es la **tercera vez en el día** que un backtick dentro de un texto se ejecuta
2159([[heredoc-sin-comillas-ejecuta-comentarios]]), y las dos anteriores sólo se comieron un comentario.
2160La regla deja de ser de estilo: **nunca un backtick dentro de comillas dobles en una shell** —
2161comillas simples, o `$(printf '%s' …)`, o directamente no poner el acento grave en el texto.
2162
2163#### Lo que queda para cerrar el frente del cortafuegos
2164
2165El kernel ya no estorba; falta **la política**: `PoliticaEntrada` (.ron) → `generate-input` →
2166`apply-input` del cortafuegos de tawasuyu, con los puertos reales de la caja (`22022`, `2345`, `80`,
2167`443`, `1137`). ⚠ Y hay que aplicarla con **interruptor de hombre muerto** (aplicar, esperar, y
2168`flush` automático si nadie confirma): una regla mal puesta en una caja **sin consola serie** deja
2169la única salida en `hcloud server enable-rescue`.
2170
2171### 6.32 🧱 El cortafuegos, puesto — y el primer baneado fui yo *(2026-09-15)*
2172
2173La caja filtra: `table inet tawasuyu_input`, **`policy drop`**, 15 reglas de puerto, y el set `ban4`
2174llenándose solo con lo que golpea desde internet. A los pocos minutos: **27 IPs baneadas y paquetes
2175tirados por el contador**. Eso es el reemplazo de fail2ban funcionando sobre tráfico real, dentro del
2176kernel y sin daemon.
2177
2178La política vive en `scripts/servidor/cortafuegos-entrada.ron` (formato `PoliticaEntrada` del
2179cortafuegos de tawasuyu) y declara los cinco puertos públicos: `22022` admin, `2345` git, `80`, `443`
2180y `1137` el proxy. El reglaset se genera con `cortafuegos generate-input` **en el hub** —el binario es
2181glibc y la caja es musl— y se aplica allá con `nft -f`.
2182
2183#### 🧨 El primer baneado fui yo, en segundos
2184
2185Aplicada la primera versión, desde fuera: `ssh` ✅, `https` ✅… y **`http`, el proxy y el git por SSH
2186muertos**. Al minuto, la caja entera dejó de contestarme.
2187
2188La causa no es una regla mal escrita: **el set `@ban4` es UNO SOLO para todos los servicios**, y la
2189regla `ip saddr @ban4 drop` está antes que todo. O sea que pasarse de tasa en *un* puerto te tira en
2190*todos*. Y el `nuevas_por_min: 5` del puerto de administración —correcto contra internet— es
2191exactamente lo que **me** pasa a mí: cada comando remoto de esta sesión es una conexión nueva.
2192
2193Lo que devolvió la máquina fue el **interruptor de hombre muerto**: antes de aplicar se deja
2194programado un `nft flush ruleset` a 180 s, y sólo se desarma si la verificación desde fuera sale
2195bien. Sin consola serie, esa es la diferencia entre un susto y un rescue.
2196
2197⚠ **Y el tipo ya lo avisaba.** `PoliticaEntrada` tiene un campo `confiables` cuyo comentario dice,
2198palabra por palabra, lo que me acababa de pasar: *«un `nuevas_por_min` chico en el puerto de SSH es
2199exactamente lo que se quiere contra internet y exactamente lo que te deja afuera cuando el que abre
2200seis sesiones en un minuto sos vos»*. Copié el `.ron` de ejemplo en vez de leer el tipo. Es
2201[[lei-hasta-donde-me-daba-la-razon]] otra vez, y la cura fue una línea:
2202`confiables: ["204.168.193.248", "154.197.1.13"]` — el hub y el worker, que se aceptan **antes** de
2203la lógica de tasa y por lo tanto no pueden entrar al set.
2204
2205#### Lo que este kernel todavía no puede, dicho en voz alta
2206
2207`nft -c` rechazó **cinco reglas** antes de aplicar nada:
2208
2209    tcp dport 22022 ct count over 10 drop
2210                    ^^^^^^^^  Error: Could not process rule: No such file or directory
2211
2212`ct count` es `CONFIG_NFT_CONNLIMIT`, que el kernel de hoy no trae (el `.config` lo dice:
2213`# CONFIG_NFT_CONNLIMIT is not set`). Es el tope de conexiones **concurrentes** por servicio — el ban
2214por tasa, que es lo que reemplaza a fail2ban, no depende de él. Las cinco reglas quedan
2215**comentadas, no borradas**, en el fichero que se aplica: *lo que la política declara y el kernel no
2216puede tiene que verse*. El símbolo ya entró a `recipes/linux-generic.toml` y vuelve con el próximo
2217kernel; hasta entonces el mensaje —que no nombra la opción que falta— queda explicado ahí mismo.
2218
2219#### Que sobreviva al reinicio: un servicio `oneshot`
2220
2221`recipes/nftables.toml` declara ahora su `[[service]]` con `lifecycle = "oneshot"`: **cargar un
2222reglaset no es un daemon, es un acto**. Va **primero en el genesis**, antes que sshd y los demás:
2223entre que la red está y que las reglas cargan, la caja está abierta, y ese hueco se hace lo más
2224corto posible. Probado de verdad — `nft flush ruleset` y después `arjectl start cortafuegos`: las 15
2225reglas vuelven.
2226
2227Su guarda sale **78 nombrando el fichero** si el reglaset no está, en vez de dejar la caja sin
2228filtrar creyendo que está protegida: *un cortafuegos ausente y uno vacío se ven igual desde afuera
2229hasta que alguien prueba*.
2230
2231### 6.33 🧨 EL CORTAFUEGOS BANEÓ A LOS USUARIOS DEL PROXY — y squid nunca se cayó *(2026-09-16)*
2232
2233El usuario preguntó si el proxy estaba caído. **No lo estaba**: el ente `squid` llevaba horas
2234`corriendo` con `↻ 0`, escuchando en `:1137` y contestando `407` a quien preguntara. Lo que estaba
2235caído era **el acceso**: el cortafuegos que puse ayer estaba baneando a los usuarios autorizados.
2236
2237La prueba, en una línea: **`154.197.1.2` —una IP que está en la ACL de squid, o sea gente con
2238contraseña— apareció en `@ban4`**. Y el contador del ban iba en **38.246 paquetes tirados**.
2239
2240#### La causa no es la tasa: es la RÁFAGA
2241
2242    tcp dport 1137 ct state new add @ban4 { ip saddr timeout 300s limit rate over 300/minute burst 5 packets } drop
2243
2244`burst 5` significa «tolero cinco conexiones por encima del promedio». **Un navegador o un agente
2245detrás de un proxy abre decenas de CONNECT en el mismo instante**, aunque su promedio sea bajísimo:
2246seis de golpe y ya estás en el set. Y como **`@ban4` es UN SOLO set consultado antes que todo**,
2247caer por el puerto del proxy te tira también el web y el git.
2248
2249⚠ El tipo del cortafuegos ya traía el campo (`rafaga`, default 5) con un comentario que decía
2250«para un servicio web va alto (100-200)». Otra vez: **leí el `.ron` de ejemplo y no el tipo**.
2251
2252#### Lo que se hizo, en orden de urgencia
2253
22541. **`nft flush set … ban4/ban6`** — servicio restaurado en el acto.
22552. **Los usuarios del proxy a `confiables`**: la misma lista que la ACL de squid (21 IPs + 5 redes).
2256   Un proxy que autentica no necesita que el kernel le cuente las conexiones a un usuario conocido;
2257   lo que el ban tiene que parar son las fuentes DESCONOCIDAS.
22583. **`rafaga` por servicio, según su clientela**: ssh 5 · git 20 · web 100 · **proxy 200**. Y el
2259   proxy pasa a `1200/min` con ban de 60 s: red de contención contra un flood, no control de uso.
22604. Control después: **cero autorizados en el set**, 24 baneados (escáneres, que es lo que se quiere),
2261   y tráfico real pasando — `154.194.14.37 … CONNECT api.deepseek.com:443 sigma`, 298 K tunelados.
2262
2263⚠⚠ **Y un fallo de método que casi lo tapa: `nft -f` SUMA a la tabla existente.** Cargué el reglaset
2264corregido encima del viejo y quedaron **30 reglas**: las viejas ADELANTE, así que los `confiables`
2265nuevos no llegaban a evaluarse nunca. Se vio contando (`grep -c dport` daba 30 y no 15) y mirando
2266qué `saddr` salía primero. Por eso `cortafuegos apply-input` **borra la tabla antes de cargar** —
2267usar `nft -f` a pelo se saltea esa mitad.
2268
2269#### La hora exacta, reconstruida del `access.log`
2270
2271El usuario preguntó a qué hora se bloqueó, y el log lo dice sin ambigüedad. Su IP —`45.234.61.160`,
2272autenticada como `sergio`, **2709 peticiones**— tuvo estos silencios:
2273
2274| silencio | desde | hasta |
2275|---:|---|---|
2276| **93,2 min** | 16-09 **11:59:37** UTC | **13:32:49** UTC ← cuando vacié los sets |
2277| 50,1 min | 10:44:58 | 11:35:06 |
2278| 10,0 min | 11:45:06 | 11:55:05 |
2279
2280Los tres son el **`timeout` de 10 minutos del ban disparándose una y otra vez**: cada vez que volvía,
2281su primera ráfaga lo baneaba de nuevo. `154.197.1.2`, que usa el proxy de forma sostenida pero sin
2282ráfagas, sólo perdió huecos de 5 minutos.
2283
2284🧨 **Y la exención que tenía no servía: su IP no estaba en la red eximida.** La ACL histórica de squid
2285exime `45.234.60.0/24` y él entra desde `45.234.61.160` — **una red de al lado**. Parecía cubierto y
2286no lo estaba: la pertenencia se MIDE (`ip in red`), no se deduce del parecido del prefijo. Con el
2287`/23` que nft dedujo al unir los dos `/24`, ahora sí.
2288
2289#### Y la decisión de fondo: en un servicio que YA AUTORIZA, no va límite por tasa
2290
2291El uso real de esta caja es **intensivo** —varias sesiones de agente en paralelo, cada una abriendo
2292túneles a la vez—, y un límite calibrado para «una persona normal navegando» no protege de nada: el
2293atacante ajusta su ritmo, el usuario no puede trabajar más despacio. Squid ya pide usuario y
2294contraseña y tiene su ACL; el ban por tasa ahí no agrega seguridad, agrega cortes. Queda apagado
2295(60000/min, ráfaga 1000: números que ningún cliente real alcanza) y contra un flood queda el tope
2296GLOBAL `syn_nuevas_por_seg`, que no distingue usuarios ni banea a nadie por ser rápido.
2297
2298#### Lo que esto enseña del cortafuegos como herramienta
2299
2300Un cortafuegos correcto y un cortafuegos usable no son lo mismo, y la diferencia **no se ve al
2301aplicarlo**: las reglas cargan, el `nft -c` pasa, los sitios responden, y el daño aparece sólo cuando
2302un cliente REAL hace lo que los clientes reales hacen. El único control que lo habría cazado antes es
2303el que no corrí: **una ráfaga de conexiones desde una IP que NO esté en `confiables`**.
2304
2305### 6.34 📋 Censo del 2026-09-16: queda UN vhost — y el censo sin privilegio no veía 572 M
2306
2307Censo fresco de gioser (`censar.py --local --probe-dns`, sólo lee), para saber **qué falta de
2308verdad** en vez de arrastrar la lista del 11.
2309
2310```
2311  servicios   vivo 23 · no-declarado 17 · declarado-muerto 81 · descartados 6
2312  dominios    apunta-aca 1 · ya-mudado 6 · fosil-sin-dns 7
2313  datos       /home 25 G (copiar 27 G) · /var/lib 8,1 G · /opt 1,2 G · /var/www 288 M
2314```
2315
2316**De los 29 dominios del Caddyfile sólo UNO sigue sirviéndose desde gioser: `sergio.gioser.net`.**
2317Comprobado desde fuera, resolución + HTTP, no por el fichero de config:
2318
2319| dominio | resuelve a | HTTP |
2320|---|---|---|
2321| `tawasuyu.net` · `gioser.net` · `git.tawasuyu.net` · `takana.gioser.net` · `hifas.gioser.net` · `api.sergio.gioser.net` | `2.29.29.217` | 200 |
2322| `gitea.gioser.net` | `2.29.29.217` | 301 |
2323| **`sergio.gioser.net`** | **`204.168.193.248` (gioser)** | 200 |
2324| `api.summa.gioser.net` | `154.197.1.2` (otra máquina) | — |
2325| `terapeuta.ec`, `andino.ec`, `api.sigma…` y 4 más | **sin DNS** | — |
2326
2327⇒ la lista de «tres vhosts» del §9 quedó vieja: `gioser.net` y `tawasuyu.net` ya están mudados
2328(§6.26) con su origen vivo a propósito. **Lo único que ata el DNS a gioser es la consola de `sergio`.**
2329
2330#### El rescate del §6.20 sigue vigente — y caduca de verdad
2331
2332Seis procesos corren hoy desde un **inodo borrado**. Cuatro tienen su copia en
2333`work/mudanza/rescate/` y el sha256 del `/proc/<pid>/exe` vivo **coincide bit a bit** con lo
2334rescatado el 12. Los otros dos (`/usr/local/bin/tejido` y `/usr/local/bin/shuma-daemon`) **no están
2335en el rescate**, pero en disco hay una versión **más nueva** de cada uno (hoy 11:13 y 14:20): no se
2336perdió nada porque el usuario los está reconstruyendo. La lección es la del §6.20 y no cambió: *ese
2337paso caduca, y quién caducó se ve mirando `/proc`, no el directorio*.
2338
2339#### 🕳️ Y el hallazgo del día: `-e` contesta «no existe» cuando lo que pasa es «no puedo mirar»
2340
2341El censo tiene tres estados a propósito (`ausente` / `sin_permiso` / `ok`) porque un `ls` sin
2342permiso se lee igual que un directorio vacío. Pero el tercer estado sólo se detectaba **sobre la
2343propia ruta**: cuando el que no deja pasar es un **ANCESTRO**, `[ -e "$p" ]` contesta que no, y la
2344ruta caía en `ausente` — que el censo **descarta sin decir nada**.
2345
2346```
2347  /root/.local        drwx------ root root        ← 0700
2348  /root/.local/bin    572 M de binarios a mano que NINGÚN paquete provee
2349```
2350
2351Corrido como `sergio`, el censo decía que `/root/.local/bin` no existe. Corrido como root, son
2352**572 M** de exactamente la clase que la mudanza no puede reconstruir: binarios puestos a mano.
2353Arreglado —si un ancestro existe y no es atravesable, el estado es `sin_permiso`— y probado en los
2354dos sentidos, que es lo que distingue un guardián de un adorno:
2355
2356```
2357  ancestro 0700 de otro dueño   →  sin_permiso   (y sale en el ⚠ del resumen)
2358  ruta que NO existe de verdad  →  ausente       (y NO se reporta)   ← el control que tiene que pasar
2359```
2360
2361Con el arreglo, el censo como `sergio` pasa de **2 rutas ciegas a 13** — entre ellas el home entero
2362de `artix`, que antes no figuraba de ninguna manera. **El censo se corre como root**; la lista de
2363ciegas es el recibo de lo que una corrida sin privilegio no puede ver.
2364
2365#### Lo que queda, y por qué no lo decide el programa
2366
2367Descontados los que ya se decidieron (§6.30: `qdrant`, `act_runner`, `fail2ban` mueren) y los que
2368provee el init del destino, lo que sigue vivo en gioser es **un montón de daemons de tawasuyu que
2369ningún paquete provee** — binarios a mano en `/usr/local/bin` (1,2 G) y `~/.local/bin` (765 M + 572 M
2370en el home de root):
2371
2372```
2373  shuma-daemon · shuma-gateway (:7378)   la consola de sergio.gioser.net — el único vhost que queda
2374  willay-daemon · willay-crosscheck · tejido (:4102,:33097) · pacha · pacha-secretos
2375  matilda · tupu · thasnuna · sandokan-watch · openclaw · zeroclaw
2376  puerta-f6e393ffbef3999e (:34221,:44961)   binario de test en target/debug, BORRADO del disco
2377  webhook-deploy.py
2378```
2379
2380`planear.py --revisar` los saca con su motivo, pero **la decisión es del usuario y el programa no la
2381va a inventar**: son las herramientas propias del usuario, no servicios de un catálogo. Y los
2382**datos** tampoco se recomiendan solos (§3): `/home` son 25 G que incluyen 6,8 G de `.claude` y
23831,3 G de binarios sueltos.
2384
2385### 6.35 🧳 Los binarios sueltos, desglosados — y qué de `.claude` viaja *(2026-09-16)*
2386
2387Decisión del usuario sobre el §6.34: **shuma se construye desde tawasuyu** (ya está encolado:
2388`recipes/incoming/shuma-{gateway,daemon}.toml`), **los daemons de tawasuyu viven todos**, y de
2389`.claude` decide el criterio de quien lo usa. Falta el detalle de los sueltos, que es esto.
2390
2391#### Son 2,7 G en tres directorios, y casi nada de eso es irreemplazable
2392
2393| clase | cuánto | qué es | se reconstruye |
2394|---|---|---|---|
2395| **tawasuyu** | 57 ficheros · **1003 M** | `pata-llimphi` 105 M, `nahual-shell-llimphi` 98 M, `shuma-shell-llimphi` 76 M, los 14 `mirada-*`, `pata-*`, `shuma-*`, `sandokan-*`, `willay-*`, `pacha`, `tejido`, `tupu`, `matilda`, `thasnuna`… | **sí**: son salida del monorepo, que ya vive en el gitea de la caja |
2396| **terceros** | 10 ficheros · **841 M** | `kiro-cli*` 571 M (tres binarios), `kcl` 95 M, `qdrant` 91 M (muere, §6.30), `gitea-runner` 21 M, `act_runner` 21 M (muere), `listmonk` 19 M, `hcloud` 18 M, `goaccess` 3,4 M | no, pero **se vuelven a bajar de su origen** |
2397| **respaldo / duplicado** | 21 ficheros · **876 M** | `/root/.local/bin` es **una copia entera de `kiro-cli*`** (571 M) más el CLI de `claude` (219 M); el resto son `.respaldo-FECHA`, `.previo` y `.bak` | no hace falta |
2398| **guiones** | 27 ficheros · **< 1 M** | `git-deploy`, `webhook-deploy.py`, `update-squid-allowed-ips.sh`, `mirada-session*`, `huellita-aviso`… | **NO** ← lo único de verdad frágil |
2399
2400⇒ **lo caro no es lo valioso**. De los 2,7 G, 1,8 G son reconstruibles o duplicados, y lo que no
2401está en ningún repo ni en ningún paquete son **27 guiones que suman menos de un megabyte** — el
2402pegamento que nadie recuerda hasta que falta. Van al plan como una sola entrada, y con nombre.
2403
2404Y los **572 M de `/root/.local/bin`** que el censo no veía (§6.34) resultaron ser exactamente eso:
2405la copia de `kiro-cli*` que ya está en el home de `sergio`. La lección no cambia —un censo que dice
2406«no hay nada» de lo que no pudo mirar es peor que uno que falla—, pero el contenido, esta vez, era
2407duplicado.
2408
2409#### `.claude`: 6,8 G en disco, **15 M es lo que hace falta para seguir funcionando igual**
2410
2411Criterio, porque es lo que me deja trabajar allá como acá:
2412
2413| viaja | qué | tamaño |
2414|---|---|---|
2415| ✅ | `projects/*/memory/` de los 18 proyectos — la memoria destilada | **6,2 M** |
2416| ✅ | `settings.json`, `plugins/`, `history.jsonl` | ~8,6 M |
2417| ⛔ | `jobs/` (5,3 G), `downloads/` (228 M), `archivo-sesiones/` (286 M), `file-history/`, `shell-snapshots/`, `cache/`, `paste-cache/` | 6,1 G |
2418| ⚠ | `projects/*/*.jsonl` — los transcripts crudos (973 M) | ver abajo |
2419
2420Los **transcripts no hacen falta para funcionar**: la memoria es su destilado y es lo que se lee al
2421arrancar una sesión. Lo que se pierde sin ellos es `--resume` de una sesión vieja y la posibilidad
2422de releer una conversación que nadie resumió. Por eso no van a la caja —que tiene 42 G libres en
2423`/work` y los quiere para el store— sino al **Storage Box del respaldo**, que es donde vive lo que
2424se guarda por si acaso. La memoria, en cambio, viaja con la máquina.
2425
2426#### ⚠ Y una trampa de ruta que haría todo esto inútil
2427
2428**La memoria se indexa POR RUTA**: el directorio se llama `-mnt-vvv-takana` porque el repo vive en
2429`/mnt/vvv/takana`. En la caja el repo está en **`/opt/takana`** ⇒ copiar `memory/` tal cual deja los
2430163 ficheros en disco y **ninguno se encuentra**, sin que nada falle. Las dos salidas son renombrar
2431el directorio a la ruta de destino (`-opt-takana`) o darle al repo la misma ruta que acá. Se elige
2432al copiar, no después.
2433
2434#### 🕳️ La caja no tiene usuario `sergio`
2435
2436`/etc/passwd` de `2.29.29.217`: `root`, `sshd`, `gitea`, `proxy`. Nada más. En gioser,
2437`shuma-daemon` corre como `sergio` —y `shuma-gateway` también—, así que la tarjeta de arje que los
2438declare tiene que **crear la cuenta primero**; y el payload `Native` de arje **no tiene campo de
2439usuario** (SDD 29 §4.0 quinquies), así que declararlos sin más los pone a correr como root. Es la
2440misma advertencia que ya lleva `recipes/incoming/shuma-daemon.toml` en su cabecera, escrita donde se
2441va a leer.
2442
2443### 6.36 🚚 Lo que se movió hoy — y las cuatro verificaciones que se hicieron EN DESTINO *(2026-09-16)*
2444
2445Con las decisiones del §6.35 puestas, se movió lo que no dependía de nada más. **Cada copia se
2446verificó del lado del destino**, que es la regla que el `rsync` con exit 0 y 1367 artefactos vacíos
2447dejó escrita (§6.13, y la regla 2 de `aplicar.py`).
2448
2449| qué | a dónde | verificación en destino |
2450|---|---|---|
2451| **los 27 guiones** (75 KB) | `takana:/work/rescate-guiones/` | `sha256sum -c SHA256SUMS` ⇒ **27 OK** |
2452| **la memoria de Claude** (733 ficheros, 6,3 M) + `settings.json`, `plugins`, `history.jsonl` | `takana:/root/.claude/` | 733 ficheros en origen y **733 en destino** |
2453| **los transcripts crudos** (1 966 ficheros, 1,3 G) | Storage Box `claude-gioser/` | `rsync -an` de vuelta: **1 solo fichero pendiente**, y es el transcript de la sesión que estaba escribiéndolo |
2454| **la clave PRIVADA de release** | `takana:/root/.config/takana/keys/` 0600 | sha256 idéntico en los dos lados **y** su pública == `trust/release.ed25519.pub` |
2455| credenciales y config (gitconfig, npmrc, gh, ssh, crontabs, Caddyfile) | `takana:/work/mudanza-secretos/` 0700 | 27 ficheros en origen y **27 en destino** |
2456| estado de los daemons que viven (`sigma`, `tupu`, `willay`, `sandokan-watch.json`) + `/var/www/para-respaldar` | `takana:/work/mudanza-estado/` | 351 ficheros y 68 M en los dos lados |
2457
2458#### ⚠ Las credenciales NO se instalaron en su sitio, a propósito
2459
2460La caja **ya tiene** su `/root/.ssh` (con `github5`), su crontab (el latido de la caja, §6.29) y su
2461`/etc/caddy/Caddyfile` con los siete vhosts que ya sirve. Pisar cualquiera de los tres con el de
2462gioser rompe lo que hoy funciona. Quedan en `/work/mudanza-secretos/` con su `LEEME.txt`, y se
2463instalan **cuando se mude el hub**, que es otra unidad de trabajo. El `.gitconfig` es el caso más
2464claro: trae los `insteadOf` que **reescriben remotos**, así que instalarlo cambia a dónde empuja
2465`git push` sin que nadie lo pida.
2466
2467La **única** excepción es la clave de release, que sí fue a su ruta canónica: sin ella nadie puede
2468volver a firmar el repo, y ese fallo no aparece el día que se borra gioser sino la próxima vez que
2469alguien publica.
2470
2471#### 🔍 Un «576 M contra 1,3 G» que parecía una copia a medias
2472
2473`du -sh` en el Storage Box decía **576 M** de los 1,3 G subidos. Con el antecedente del rsync que
2474llenó el disco, eso se lee como copia truncada. No lo era: el Storage Box **comprime**, y su shell
2475restringida no tiene `find` ni acepta tuberías, así que el conteo de ficheros —la verificación
2476obvia— ahí no se puede hacer. Lo que sí se puede es **preguntarle a rsync**: una corrida `-an`
2477compara tamaño y fecha contra el destino real y dijo **1 fichero pendiente**, el que estaba
2478creciendo mientras se copiaba.
2479
2480⇒ *la verificación tiene que poder correrse en el destino que hay, no en el que uno imagina*. Y un
2481número que no cuadra merece una segunda medición antes de un diagnóstico: `du` medía otra cosa.
2482
2483#### Lo que NO se movió, y no es olvido
2484
2485**~10 G de árboles personales en `/home/sergio`** —`android-sdk` 1 G, `maps`, `imm`, `humanoid`,
2486`hifas`, `fdroid`, `valens-conversion`, `pyswisseph`, `accordion`…— y `/opt` (1,2 G, que es
2487`android-sdk` otra vez y `google`). **Qué datos valen no se deduce de la máquina** (§3), y éstos son
2488proyectos del usuario, no servicios de un censo: van a la lista de decisiones, no a una copia hecha
2489por criterio ajeno.
2490
2491De `/var/lib` (8,1 G) se movió sólo el estado de los daemons que viven: **6,1 G son swap** y 1,9 G
2492el gitea, que ya está mudado desde el §6.14.
2493
2494### 6.37 ✅ CUTOVER DE `sergio.gioser.net` — el último vhost, y gioser deja de servir *(2026-09-16)*
2495
2496**Ya no queda ningún dominio sirviéndose desde gioser.** El último era éste, y lo que lo ataba no
2497era el sitio sino su consola: `/shuma/*`. Verificado desde fuera, contra la IP nueva:
2498
2499```
2500  https://sergio.gioser.net/           → 200   408 bytes, la SPA
2501  https://sergio.gioser.net/shuma/     → 200   «shuma-gateway ok»   ← el gateway, no la SPA
2502  https://sergio.gioser.net/ruta-inventada → 200  la SPA (el fallback, que es lo correcto)
2503```
2504
2505⚠ **El `200` de `/shuma/` había que mirarlo dos veces.** El bloque termina en
2506`try_files {path} {path}/ /index.html`, así que **cualquier ruta inexistente devuelve 200 con la
2507SPA**: un `curl -o /dev/null` que sólo mira el código habría dado el mismo verde con el proxy mal
2508puesto. Lo que decide es el CUERPO — 17 bytes que dicen `shuma-gateway ok` — y el control es
2509compararlo con lo que el origen viejo sigue sirviendo, byte por byte. Igual con `/shuma/rpc`: las
2510dos máquinas contestan el MISMO `400 {"error":"bad json: …"}`.
2511
2512#### Lo que hubo que construir, en orden
2513
25141. **Las dos recetas** (§6.34) sellaron en el worker: `b3:107dfb54…-shuma-gateway` (6,3 M) y
2515   `b3:f9b92acc…-shuma-daemon` (5,6 M) — los hashes que `takana hash` había anticipado antes de
2516   encolarlas. `file` dice **`statically linked`**: nada de cargador, que era exactamente lo que le
2517   faltaba al binario glibc de gioser (y cuyo inodo, además, ya estaba borrado del disco).
25182. **La cuenta, declarada y sin privilegio.** `[[user]] shuma` (uid 967) en la receta del daemon, y
2519   el descenso con `setuidgid` dentro del `argv` de la Card, igual que gitea — porque el payload
2520   `Native` de arje **no tiene campo de usuario**. Declararlo «como estaba» lo habría puesto de
2521   root, y esto es un demonio que abre PTYs y lanza shells.
25223. **⚠ Y la shell de la cuenta NO es un detalle.** El default de `[[user]]` es `/bin/false`, que es
2523   lo correcto para gitea o squid y **exactamente lo contrario** para éste: con la shell inerte el
2524   servicio arranca, se supervisa, contesta 200… y cada pestaña que alguien abra muere al instante.
2525   Un fallo que no se ve al desplegar: se ve al usarlo. Va `shell = "/bin/sh"`.
25264. **La config que no se regenera.** El `gateway-token` (32 B) y `keys/identity.x25519` viajaron a
2527   `/var/lib/shuma/.config/shuma/`: generar unos nuevos deja fuera a los clientes ya emparejados.
2528   Por eso la guarda de la Card **exige** el token y no lo crea, y dice de dónde sale.
25295. **Las dos Cards** entran en `/etc/arje/cards.d/` **y** en el `genesis` de `/ente/seed.card.json`
2530   (son dos preguntas distintas: qué se puede encarnar a pedido y qué arranca solo). La semilla
2531   quedó con 13 entradas y vuelve a parsear.
25326. **Declarado en `perfil.servidor`**: los dos paquetes y los dos labels en `servicios`. Entran como
2533   PAR — el gateway sin el daemon es un puente a ninguna parte.
2534
2535`[[user]]` y `[[service]]` están **fuera de `hash_inputs`**, así que declarar todo eso no movió
2536ningún ArtifactHash: comprobado en los dos, antes y después.
2537
2538#### 🔁 El DNS: la API tiene una acción para esto y el §6.25 no la había encontrado
2539
2540Aquel cutover dejó escrito «un `PUT` sobre el rrset no puede cambiar el tipo: hay que `DELETE` del
2541CNAME y `POST` del A». Es cierto para un cambio de TIPO. Para cambiar el VALOR, el `PUT` tampoco
2542sirve —`can't update records with this endpoint`— pero existe una acción que lo hace **atómica**:
2543
2544```
2545POST /v1/zones/<id>/rrsets/<nombre>/<tipo>/actions/set_records   {"records":[{"value":"…"}]}
2546```
2547
2548Sin ventana sin registro, que es lo que sí tiene el `DELETE`+`POST`. Con TTL 60 la resolución
2549pública cambió **en menos de 8 segundos**, y volver atrás es la misma llamada con la IP vieja.
2550
2551#### El origen sigue vivo, a propósito
2552
2553Como en §6.26: en gioser `shuma-daemon`, `shuma-gateway` y su bloque de caddy **siguen corriendo**.
2554Mudar el nombre y dejar el origen encendido permite volver en un minuto, y no cuesta nada mientras
2555la máquina exista. Lo que ya no existe es la dependencia: **ningún dominio resuelve a gioser**.
2556
2557⚠ Pendiente menor, anotado donde se va a leer: el daemon avisa al arrancar que no encuentra
2558`shuma-askpass` («sudo/ssh pedirán la clave por el TTY»). Es otro crate del mismo workspace y es
2559otra receta — no bloquea la consola.
2560
2561### 6.38 🧩 Los primeros cuatro daemons propios, corriendo en la caja *(2026-09-16)*
2562
2563De las diez recetas encoladas, cuatro sellaron y ya corren supervisadas por arje:
2564
2565| | cuenta | qué hace, comprobado |
2566|---|---|---|
2567| `matilda` | **root** | lee el access log de caddy y archivó **78 ficheros** en `/var/lib/tupu/takana/` |
2568| `pacha` | `pacha` (965) | vivo, 0 reinicios, con SUS reglas (`reglas.ron`), no las de fábrica |
2569| `pacha-secretos` | `pacha` | vivo, 0 reinicios — y su binario en gioser era un **inodo borrado** |
2570| `sandokan-watch` | root | **frenado a propósito**: no puede trabajar acá (ver abajo) |
2571
2572#### ⚠ Tres corren como ROOT, y está declarado en vez de heredado
2573
2574Lo natural sería una cuenta sin privilegio por servicio, como `shuma` o `gitea`. Con el trío de la
2575telemetría **no se puede**, y las dos razones son medidas:
2576
25771. `matilda` lee `/var/log/caddy/requests.json`, que caddy crea **`-rw------- root root`** y recrea
2578   igual en cada rotación: un grupo con permiso de lectura se pierde en la próxima.
25792. `tupu`, `matilda` y `sandokan-watch` escriben en el MISMO `/var/lib/tupu`, y en gioser sus 322
2580   ficheros son `root:root`. Bajar uno solo deja **mezcla de dueños en un árbol compartido**: escribe
2581   el primero y los otros fallan al modificar.
2582
2583⇒ o los tres como root, o ninguno. La salida limpia está anotada en la receta para el día que se
2584quiera: que caddy escriba con `mode 640` y que el árbol sea de una cuenta propia. `pacha` y
2585`pacha-secretos` sí bajan a una cuenta propia, porque en gioser tampoco corrían como root.
2586
2587#### 🕳️ La caja se llamaba «(none)» — y eso se archivaba
2588
2589`matilda` archiva POR MÁQUINA, y sus primeros 72 ficheros fueron a `/var/lib/tupu/**none**/`:
2590
2591```
2592  $ hostname          →  (none)
2593  $ cat /etc/hostname →  no existe
2594```
2595
2596**Ninguna caja takana fija su hostname**: no lo hace `netup`, no está en el product-rootfs, no hay
2597`/etc/hostname`. Nunca importó porque nada archivaba por nombre — hasta que llegó algo que sí. Y no
2598falla: archiva bajo `none`, y dos máquinas distintas archivarían en la misma carpeta.
2599
2600Puesto `/etc/hostname` + una Card **OneShot** `hostname` en el genesis, para que sobreviva al
2601reinicio sin depender de que alguien se acuerde. Con el nombre puesto, matilda re-archiva en
2602`/var/lib/tupu/takana/`. Quedan 72 ficheros huérfanos bajo `none/`: son los 20 minutos anteriores.
2603
2604⇒ **lo correcto es que lo haga `netup`**, que es quien configura la identidad de red de la máquina;
2605la Card es la mitigación de hoy, y está dicho en su propia guarda.
2606
2607#### 🛡️ Un vigía que no vigila es PEOR que uno caído, porque el caído se ve
2608
2609`sandokan-watch` arrancó, quedó «corriendo · 0 reinicios»… y no guardaba una línea. Lo dice él mismo
2610si uno lo corre a mano:
2611
2612```
2613sandokan-watch · sin fuente de accesos (ni /var/log/auth.log ni journalctl): no se guarda nada
2614```
2615
2616En gioser lee el `auth.log` de un syslog que **en takana no existe** — no hay systemd ni syslog. Su
2617Card ahora lleva una guarda que sale **78** nombrando el problema, así que el servicio no queda
2618verde mintiendo; y **no entra al `genesis`**, sólo a `cards.d`, porque no tiene sentido que arranque
2619al boot para fallar. Destrabarlo es darle el diario de arje como fuente, y eso es trabajo de su repo.
2620
2621#### Dos herramientas que no existen donde se prueba
2622
2623Dos veredictos falsos en una tarde, los dos por probar con algo que la caja no tiene:
2624
2625- **`/dev/tcp/host/puerto` no existe en busybox `ash`** ⇒ un barrido de puertos contra gioser dio
2626  «cerrado» para los cinco, incluidos `:80` y `:443`, que sirven. Con `curl telnet://` el resultado
2627  es el contrario: `:2345` y `:443` **abiertos**, `:22` cerrado.
2628- **La expansión de llaves (`{a,b}`) tampoco** ⇒ un `ls /store/*-{matilda,pacha}` dijo que los
2629  artefactos no habían llegado. Habían llegado.
2630
2631Es la misma lección del §6.23 (`ps` y `dig` ausentes) y merece repetirse: *una prueba que no puede
2632pasar se ve igual que una que todavía no pasó*.
2633
2634### 6.39 🕸️ Los nueve daemons propios, y la línea que separa «se muda» de «se INTERCAMBIA» *(2026-09-16)*
2635
2636Nueve de las diez recetas sellaron. Cinco corren; cuatro están instaladas y **frenadas a propósito**,
2637cada una por un motivo distinto y con su guarda diciéndolo.
2638
2639| corriendo | | frenado | por qué |
2640|---|---|---|---|
2641| `matilda` · `tupu` | root, escriben `/var/lib/tupu/takana/` | `sandokan-watch` | en takana no hay `auth.log` ni journalctl |
2642| `pacha` · `pacha-secretos` | cuenta `pacha` (965) | `tejido` | **misma identidad libp2p que el de gioser** |
2643| `willay-daemon` | root, con su índice mudado | `willay-crosscheck` | necesita el roster de tejido |
2644| `shuma-daemon` · `shuma-gateway` | cuenta `shuma` (§6.37) | `thasnuna` | pide `claude` autenticado y `sandokan-mcp` |
2645
2646#### ⚠ La regla que sirvió para los vhosts NO sirve para una identidad
2647
2648Con los sitios web la pauta fue: **mudá el DNS y dejá el origen encendido**, así volver cuesta un
2649minuto (§6.26). Con `tejido` eso es exactamente lo que NO hay que hacer, y el README del propio
2650tejido lo dice: *«la clave que el roster atesta ES la identidad de transporte libp2p»*
2651(`~/.tejido/device.seed`). Dos máquinas con la misma semilla no son dos réplicas del mismo servicio:
2652son **el mismo PeerId en dos sitios**, o sea dos impostores mutuos para el resto de la flota.
2653
2654⇒ `tejido` se **intercambia**: se apaga allá, se enciende acá, en ese orden. Está todo listo para el
2655intercambio —binario, cuenta `tejido` (964), identidad instalada 700 en `/var/lib/tejido/.tejido/`—
2656y su Card vive en `cards.d` pero **no en el `genesis`**, para que un reinicio no lo encienda solo.
2657
2658Y arrastra a otro: `willay-crosscheck` **no es independiente**. Corriendo su línea a mano:
2659
2660```
2661Error: no hay roster en /root/.tejido/roster.postcard — emparejá primero (`tejido serve` / `tejido join`)
2662```
2663
2664Vive dentro de la red de tejido, así que hereda su condición. Se enciende en el mismo movimiento.
2665
2666#### Lo que cada guarda evita
2667
2668- `thasnuna`: su `INSTALAR.md` —escrito hoy por el frente tawasuyu para esta misma mudanza— pide
2669  tres cosas, y dos no están: `sandokan-mcp` en el PATH («el agente contesta pero no tiene
2670  herramientas») y **`claude` instalado y AUTENTICADO** («no hay anfitrión»). El CLI de claude es un
2671  binario **glibc de ~300 M**: en una caja musl pide jaula qorpa, como `sergioh-api`.
2672- Y de ahí sale un hallazgo que vale para el respaldo entero: ese documento explica por qué el token
2673  no va en la Card, y el motivo está medido en la máquina vieja — **la Card `openrc-openclaw` de
2674  gioser lleva la API key de su proveedor EN CLARO dentro del JSON de `/etc/arje/cards.d/`**, que es
2675  un directorio que se respalda y se copia. Un secreto dentro de una Card viaja a todas partes.
2676- `willay-crosscheck`: `--label` **nombra a la máquina**. En gioser decía `momento`; copiarlo tal
2677  cual habría hecho que la caja nueva se anunciara con el nombre de la que se borra. Ahora sale de
2678  `hostname`, y si no hay, la guarda lo dice.
2679
2680#### 🔁 Tres veredictos falsos en una tarde, los tres por probar con lo que la caja no tiene
2681
2682Van con el §6.38 y ya son patrón, no anécdota:
2683
2684| la prueba | lo que dijo | lo que pasaba |
2685|---|---|---|
2686| `/dev/tcp/host/puerto` | los 5 puertos de gioser «cerrados» | busybox `ash` no tiene `/dev/tcp` |
2687| `ls /store/*-{a,b}` | «los artefactos no llegaron» | busybox no expande llaves |
2688| `find … -newermt "-2 minutes"` | «tupu no escribe hace 2 min» | tupu **sí** escribe: su `mtime` avanza cada 10 s |
2689
2690El de `tupu` es el más instructivo porque casi produce un diagnóstico al revés: el fichero tiene
2691**tamaño constante** (es una serie de tamaño fijo), así que «no cambió de bytes» tampoco probaba
2692nada. Lo que decide es el `mtime`, medido dos veces con 40 s de por medio.
2693
2694### 6.40 🚪 Las ocho puertas, medidas de nuevo *(2026-09-16)* — y la que falta es UNA
2695
2696La tabla del §6.3 es del 10 de septiembre. Re-medida hoy, entera:
2697
2698| # | puerta | estado | medido |
2699|---|---|---|---|
2700| 1 | arranca takana puro, se entra por SSH | ✅ | sigue en pie |
2701| 2 | el store está entero | ✅ | **1632 artefactos, 0 vacíos** (eran 1362) · ⚠ `/store` al 88 %, 11,3 G libres |
2702| 3 | los cuatro grafos idénticos | ✅ | §6.7 |
2703| 4 | **la granja late en la caja nueva** | ❌ | **el latido sigue en gioser**: la caja no tiene el cron |
2704| 5 | el repo se sirve y el host se actualiza solo | ⬖ | sirve; consumir exige el lab entero (SDD 27 §4) |
2705| 6 | cada dominio vivo responde 200 desde fuera | ✅ | **los 8 contra `2.29.29.217`** — y `sergio` ya entre ellos |
2706| 7 | el respaldo corre desde la caja | ⬖ | el script **corre y lista** el Storage Box desde la caja; falta una corrida completa |
2707| 8 | lo fósil, anotado y decidido | ✅ | §6.9 + `docs/state/mudanza-decisiones.txt` |
2708
2709#### La puerta 4 es ahora una línea de crontab — y por qué no la puse
2710
2711La caja ya tiene **todo** lo que el latido necesita, comprobado uno por uno: `git`, `python3`,
2712`rsync`, `ssh`, `takana`, `flock`, la llave del worker en `/root/.ssh/github5` y el `.fleet` con
2713`dev.gioser.net`. Le faltaban dos costuras y están hechas:
2714
2715```
2716  /opt/takana/store              -> /store            (el script espera `./store`; acá es partición)
2717  /opt/takana/target/release/takana -> /usr/bin/takana (no hay árbol de build en una caja instalada)
2718```
2719
2720Y el repo de `/opt/takana`, que estaba **5 días atrasado**, quedó en `origin/main` exacto (0
2721diferencias contra el remoto), con un tar de respaldo de los 92 ficheros que el árbol tenía antes.
2722⚠ Esos 92 no eran trabajo local: eran **contenido que ya estaba río arriba** —el cambio de SSH a
2723HTTPS de las recetas de tawasuyu, entre otros— metido en el árbol sin commitear. Un árbol «sucio»
2724que en realidad está *atrasado*, que es el mismo espejismo que el §5 del informe de tawasuyu
2725describe para el monorepo.
2726
2727Prueba de sólo lectura desde la caja, que es lo más lejos que se puede llegar sin cambiar nada:
2728
2729```
2730  ▶ dev.gioser.net (154.197.1.13)   load: 2.72 · store: 895 artefactos
2731  ══ AVANCE KDE ══  197/198 sellado
2732  ══ CRON DE COSECHA ══  ⚠ NO instalado en el crontab
2733```
2734
2735**No lo instalé, y el motivo es el mismo que el de `tejido`**: con el cron puesto en las dos
2736máquinas, las dos harían `rsync --delete` del repo al worker y las dos cosecharían y commitearían.
2737El latido **se intercambia, no se duplica** — se apaga en gioser y se enciende acá, en ese orden, y
2738es el último movimiento antes del borrado.
2739
2740⇒ **de las ocho, una sola está en rojo, y es una decisión de corte, no trabajo pendiente.**
2741
2742### 6.41 🔀 INTERCAMBIO de `tejido` — la identidad cambió de máquina, no de dueño *(2026-09-17)*
2743
2744Hecho, y en este orden, que es el único posible: **apagar allá → encender acá**.
2745
2746```
2747  gioser   tejido relay (964) · tejido serve (29240) · willay-crosscheck (15334)   → detenidos
2748  takana   tejido        4102   ·  willay-crosscheck  4103                         → corriendo
2749```
2750
2751**La prueba de que la identidad VIAJÓ y no se generó otra** no es que el servicio arranque —eso
2752pasaría igual con semillas nuevas, y sería el fallo silencioso que esto existe para evitar— sino que
2753la semilla sea la misma:
2754
2755```
2756  device.seed     gioser cad6f35b633e8637…   caja cad6f35b633e8637…   ✓ idéntica
2757  roster.postcard gioser 590f2713075ac934…   caja 590f2713075ac934…   ✓ idéntica
2758```
2759
2760El `PeerId` sale de esa semilla, así que sigue siendo `12D3KooWBw2u8mt2ciUjX69qpVAZiJZ8sZMGxz8eHJEnz4rzg37L`.
2761
2762#### ⚠ LO QUE SÍ CAMBIA, Y HAY QUE TOCARLO A MANO: el multiaddr
2763
2764Los clientes tienen configurada la dirección COMPLETA del relay, IP incluida — se leyó del proceso
2765que corría en gioser:
2766
2767```
2768  antes:  /ip4/204.168.193.248/tcp/4102/p2p/12D3KooWBw2u…
2769  ahora:  /ip4/2.29.29.217/tcp/4102/p2p/12D3KooWBw2u…        ← mismo PeerId, otra IP
2770```
2771
2772Un cliente con el viejo no falla «mal»: reintenta contra una IP que pronto no existirá. **El PeerId
2773no hay que tocarlo; la IP sí, en cada equipo del roster.**
2774
2775#### 🧱 Sin el cortafuegos, el intercambio habría sido un verde falso
2776
2777El reglaset de la caja abría `80, 443, 1137, 2345, 22022` **y nada más**: `4102` estaba cerrado. Con
2778el relay encendido y el puerto filtrado, `arjectl status` diría «corriendo · 0 reinicios» y la flota
2779no llegaría — el peor de los verdes. Se abrieron `4102` (relay) y `4103` (crosscheck), con su ban
2780por tasa como el resto. **No se abrió `33097`**: ése era el puerto efímero de un `tejido serve`
2781(cliente), no un servicio que alguien busque.
2782
2783Y el reglaset quedó **idempotente**, que era deuda del §6.33: sus dos primeras líneas crean y borran
2784la tabla antes de definirla, así que `nft -f` **reemplaza** en vez de acumular. Comprobado contando:
278515 reglas `dport` antes, 21 después (no 36).
2786
2787⚠ **La política que genera ese fichero NO EXISTE EN NINGÚN DISCO.** Su cabecera dice «GENERADO, no
2788editar a mano — regenerar con `cortafuegos generate-input --policy <ruta>`», pero esa ruta no está
2789ni en la caja, ni en gioser, ni en el repo (sólo dos `politica_*_ejemplo.ron` en tawasuyu), y el
2790binario `cortafuegos` tampoco está instalado en ninguna de las dos. **El generado sobrevivió a su
2791fuente**: hasta que la política se escriba y se versione, esto se edita a mano — justo lo que su
2792primera línea pide no hacer.
2793
2794#### 🆔 `takana` acepta ULIDs que `arje-zero` RECHAZA
2795
2796La Card de tejido no encarnaba: `arje-zero rechazó: card tejido JSON: invalid character at line 7`.
2797La línea 7 es el `id`, y el id era `01M2EKDA00TEJ1D0RELAY00001` — que tiene una **`L`**, carácter
2798**excluido del alfabeto Crockford** de ULID (junto con `I`, `O`, `U`). `takana service-cards` lo
2799validó como bueno («26 caracteres alfanuméricos») y el consumidor lo tiró.
2800
2801Dos cosas de esto: el validador del PRODUCTOR es más laxo que el del consumidor —y eso siempre
2802termina en un fallo lejos de donde se escribió—, y el barrido propio que ya corrí sobre todos los
2803`id` del repo con el alfabeto correcto había marcado justo ése. Era el único con `L` (venía de
2804«RELAY»); ahora es `01M2EKDA00TEJ1D0RE1AY00001`.
2805
2806#### Estabilidad, medida y no supuesta
2807
2808`willay-crosscheck` marcaba **4296 reinicios**, que asusta hasta mirar de dónde vienen: son las
2809horas en que su guarda lo frenó a propósito por falta de roster. Con el mismo pid a los 70 s y
28101 m 53 s de vida, está estable. `tejido`: 0 reinicios. Los dos puertos aceptan conexión desde fuera.
2811
2812⚠ De paso, un detalle feo: `arjectl status | head -2` hace que **arjectl paniquee** con
2813`failed printing to stdout: Broken pipe`. No rompe nada, pero un `EPIPE` sin manejar en una
2814herramienta de operación aparece justo cuando alguien la encadena con `head`/`grep -q`.
2815
2816#### Cómo volver, si hiciera falta
2817
2818Está escrito en `work/mudanza/volver-atras-tejido.txt`: apagar los dos de la caja y relanzar los tres
2819de gioser con las líneas exactas que se leyeron de `/proc/<pid>/environ` y `cmdline`. **Nunca las dos
2820a la vez**: es la misma identidad.
2821
2822### 6.42 ❌ El latido NO se puede mudar todavía — y el motivo redefine qué es un «hub» *(2026-09-17)*
2823
2824Se intentó el último intercambio: apagar el cron de la cosecha en gioser y encenderlo en la caja.
2825**Salió mal, se vio en el primer ciclo, y se volvió atrás en minutos.** Queda escrito porque el
2826motivo no era ninguno de los que se habían previsto.
2827
2828#### Lo que sí funcionó
2829
2830La caja tiene todo lo del latido y el ciclo corrió de punta a punta: sembró el repo al worker, leyó
2831su manifiesto, regeneró los ocho ficheros de estado, pasó los vigías, **se puso al día por
2832fast-forward y commiteó+empujó**. El `git config` de identidad y el `pull --ff-only` nuevo hicieron
2833su parte.
2834
2835#### 🕳️ Lo que publicó, que es el problema
2836
2837```
2838  totals que publicó la CAJA :  {recipes: 1112, nodes: 1115, unhashable: 1112, ajeno: 3}
2839  totals de gioser           :  {recipes: 1112, nodes: 1115, sealed: 1105, never: 5, debt: 2}
2840```
2841
2842**`unhashable: 1112`** — no es «no está sellado»: es que **no se pudo CALCULAR el hash de ninguna
2843receta**. Y la causa es la misma que el §5.2 documenta desde el otro lado: **el lab entra en el
2844ArtifactHash**, así que una máquina sin el rootfs del lab no puede hashear nada. La caja de
2845producción no lo tiene — a propósito, no es un olvido.
2846
2847El daño era real y silencioso: el commit `45b5685a` dejó en `main` un `build-state*.json` que dice
2848que **el corpus entero no existe**. Cualquiera que lo lea —o cualquier vigía que lo compare— vería
28491112 recetas en cero.
2850
2851#### La lección, que vale más que el intento
2852
2853**Un hub no es «la máquina que tiene el repo y la llave»: es la que tiene el LAB.** El latido parece
2854tarea de cron —siembra, cosecha, commitea— pero su tercer paso es *pensar sobre el corpus*, y eso
2855exige el toolchain. Por eso la puerta 4 **no** era una línea de crontab, aunque todas las piezas que
2856se miraron (git, python3, rsync, ssh, takana, flock, `.fleet`, la llave) estuvieran.
2857
2858⇒ Las salidas son tres, y ninguna es «poner el cron»:
28591. **darle el lab a la caja** (`/.dev-fs/…`) — deja de ser sólo servidor y pasa a ser también hub;
28602. **partir el latido**: siembra+cosecha en la caja, regeneración del grafo donde haya lab;
28613. **que el hub sea otra máquina** (el LXC prestado ya tiene lab y muele 24/7).
2862
2863Es decisión del usuario, y es **lo único que queda entre esto y borrar gioser**.
2864
2865#### Vuelta atrás, en minutos
2866
2867Cron de la caja borrado, cron de gioser reactivado (estaba comentado, no borrado). El propio latido
2868de gioser **repara el daño solo** en su siguiente ciclo: regenera el grafo desde SU store —que sí
2869tiene el lab— y vuelve a publicar los números buenos.
2870
2871#### 🧰 Y de paso, tres cosas que el ciclo destapó en la caja
2872
2873- **`poda-fuentes.sh` no corre en takana**: `/dev/fd/63: No such file or directory` y
2874  `viejos: unbound variable`. Es **sustitución de procesos** (`<(...)`), que busybox `ash` no tiene —
2875  el cuarto tropiezo del día con la misma forma. El podador de `work/sources` es justo lo que un hub
2876  necesita para no llenarse.
2877- Los vigías corrieron y hablaron: **1 ofensor nuevo de raíces (`bzip2`)**, **3 herramientas
2878  selladas que no se pueden invocar**, y `servicios.txt` con 7 errores y 30 avisos. Son hallazgos del
2879  corpus, no de la mudanza, y quedan anotados donde el humano los mira.
2880- `arjectl status | head -2` **hace paniquear a arjectl** (`failed printing to stdout: Broken pipe`).
2881  No rompe nada, pero un `EPIPE` sin manejar en una herramienta de operación aparece justo cuando
2882  alguien la encadena.
2883
2884### 6.43 🧪 La caja ya es un HUB: el lab viajó, y con él la puerta 4 *(2026-09-17)*
2885
2886El §6.42 dejó dicho qué faltaba y el usuario eligió: **darle el lab a la caja**. Hecho, y el latido
2887ya late desde allá.
2888
2889#### El lab no se copia: se PINEA y se trae
2890
2891`scripts/lab-image.sh` empaqueta `.dev-fs/alpine` de forma **determinista** (`--sort=name
2892--mtime=@1 --owner=0 --group=0 --numeric-owner`, excluyendo `var/log/apk.log`, que es lo único que
2893difiere entre dos labs por lo demás iguales), lo publica al Storage Box con el sha en el nombre, y
2894del otro lado `--traer` **verifica el sha antes de extraer**. Eso es lo que hace que las dos máquinas
2895hasheen igual, y es un contrato, no una copia.
2896
2897**Y el empaquetado de hoy devolvió el sha que el repo ya pineaba:**
2898
2899```
2900  empaquetado hoy en gioser : d1e341d5dd434a11e2290b0340069ce4a83563eac8e4481f379b4951b1162045
2901  pineado en bootstrap-devfs.sh: d1e341d5dd434a11e2290b0340069ce4a83563eac8e4481f379b4951b1162045
2902```
2903
2904O sea dos cosas de una: **el lab de gioser nunca derivó** desde que se publicó esa imagen, y **el
2905empaquetado es reproducible de verdad** — no era una promesa del comentario.
2906
2907#### La prueba que decide, y no es que arranque
2908
2909Con el lab instalado, la caja calcula los MISMOS `ArtifactHash` que gioser:
2910
2911```
2912  zlib          b3:dc363f26…   busybox   b3:2a2b1280…
2913  caddy         b3:c915987d…   shuma-daemon b3:f9b92acc…
2914```
2915
2916Cuatro de cuatro. Si el lab fuera otro, estos números serían otros y el store no lo notaría — es el
2917agujero que `hash_inputs` cerró (§lab en el hash) y la razón por la que esto se verifica con hashes
2918y no con un «arrancó bien».
2919
2920#### Los stores, convergidos — y una trampa que me tendí solo
2921
2922El grafo seguía discrepando porque el store de la caja no tenía 24 artefactos vigentes de gioser
2923(3,0 G). Al copiarlos con `rsync -a --files-from=<lista de DIRECTORIOS>` pasó lo peor posible:
2924
2925```
2926  sent 2,281 bytes … total size is 0        ← no copió NADA
2927  artefactos en la caja: 1631 → 1655        ← pero creó los 24 DIRECTORIOS
2928```
2929
2930**`--files-from` no recursa sin `-r`**: creó 24 directorios vacíos en el store. Y un directorio vacío
2931en el store **es un cache-hit** (§3 de CLAUDE.md, [[artefacto-vacio-envenena-cache]]): `build` lo
2932habría dado por sellado y habría salido OK sin construir. Se detectó al contar, se borraron los 24 y
2933se repitió con `-r`: 3,18 GB transferidos, **0 vacíos de 1655**.
2934
2935Después faltaban dos más (`obs-studio` y `spectacle`, justo los que el worker no logra construir),
2936copiados también. Resultado:
2937
2938| | gioser | caja |
2939|---|---|---|
2940| corpus | sealed 929 · debt 2 | **sealed 930 · debt 1** |
2941| KDE | sealed 1105 · debt 2 | **sealed 1106 · debt 1** |
2942
2943La caja no empata: **gana por uno** en los dos grafos.
2944
2945#### El latido, mudado
2946
2947Cron apagado en gioser, encendido en la caja, y un ciclo completo corrido a mano para mirar lo que
2948publica: `==> repo al día (ff)` → `==> estado commiteado+pusheado`, con los números buenos. El
2949`build-state` que hay en `main` ahora lo escribió la caja.
2950
2951⚠ **Lo que queda apretado es el disco**: `/store` de la caja está al **91 %, 8,2 G libres**. Un hub
2952sella y cosecha, así que ése es el próximo muro — `scripts/store-gc.sh` es la herramienta y todavía
2953no se corrió allá.
2954
2955⇒ **puerta 4 en verde.** Con eso, de las ocho quedan sólo las dos a medias (5 y 7) y ninguna en rojo.
2956
2957### 6.44 🧹 Primer `store-gc` en la caja: 26,8 G — y dos bugs que sólo salen fuera de GNU *(2026-09-17)*
2958
2959El store estaba al **91 %** (8,2 G libres) justo cuando la caja pasó a ser hub, que es la peor
2960combinación: un hub sella y cosecha.
2961
2962```
2963  antes:  84,7 G usados · 8,2 G libres · 91 %  · 1657 artefactos
2964  después: 57,9 G usados · 35,0 G libres · 62 % · 1320 artefactos
2965```
2966
2967**337 artefactos superados borrados y verificados (0 sobrevivientes), 26,8 G.** El default del gc no
2968toca los **150 huérfanos** —`11,4 G`, los que son el único ejemplar de su nombre— y eso está bien:
2969borrarlos es la diferencia entre «se reconstruye en dos minutos» y «hay que rehacer la torre».
2970
2971#### El control que hay que correr DESPUÉS de un gc en esta caja, y que no es obvio
2972
2973**11 binarios de `/usr/bin` son symlinks que apuntan DENTRO del store** — los daemons que se
2974instalaron estos dos días. Un gc que borre el artefacto equivocado no rompe el store: rompe el
2975`/usr/bin` de una máquina en producción. Antes de `--aplicar` se comprobó que los 11 enlazan al hash
2976**vigente** (y por lo tanto están en el conjunto protegido); después, que los 11 siguen resolviendo y
2977que los 21 entes siguen corriendo. Los dos controles pasaron.
2978
2979⚠ Y la advertencia que el propio gc imprime y que en esa caja **no se puede satisfacer**: «sin
2980`.config` legible (ni `/proc/config.gz` ni `/boot/config-…`) ⇒ NO se protege ningún kernel por esta
2981vía». Con el default da igual; con `--huerfanos` en una máquina que arranca de su store, no.
2982
2983#### Los dos números que el gc no sabía decir
2984
2985Funcionó, pero sus dos cifras salieron vacías — y son las que uno mira para decidir si vale la pena:
2986
2987```
2988  ==> espacio: superados  · huérfanos
2989  ==> 337 artefactos borrados y VERIFICADOS · libres: Available → Available
2990```
2991
29921. **`du -sch --files0-from=-` es de GNU y busybox no lo tiene** ⇒ `espacio()` devolvía vacío. *Un
2993   número que falta se lee como un número chico.*
29942. **`df -h /home` estaba cableado** y el store no vive ahí: en gioser es un bind-mount del volumen,
2995   en la caja es `/store`. Sin `/home`, `tail -1` se quedó con la CABECERA — de ahí
2996   «Available → Available».
2997
2998Arreglados los dos… y el primer arreglo **también estaba mal**: `xargs -d '\n'` es otra extensión
2999GNU. Eso imprimió `huérfanos ?`, y ese `?` es deliberado: cuando el total no se puede calcular, la
3000función lo DICE en vez de escribir 0 — un cero inventado habría dicho «no hay nada que ganar» con
300111,4 G en huérfanos. Con `tr '\n' '\0' | xargs -0`, que busybox sí tiene, la caja ya contesta
3002**`espacio: superados 0 · huérfanos 11.4G`**.
3003
3004⇒ Van **cinco** tropiezos del mismo día con la misma forma (`/dev/tcp`, expansión de llaves,
3005`find -newermt`, sustitución de procesos, y estos dos). El patrón ya no es anécdota: **un script del
3006hub escrito en una máquina GNU no corre en la caja hasta que se prueba ahí.**
3007
3008### 6.45 🧯 `poda-fuentes` tampoco corría — y la causa no era el script: **la caja no tiene `/dev/fd`** *(2026-09-17)*
3009
3010El latido, desde la caja, moría así en su paso de poda:
3011
3012```
3013  poda-fuentes.sh: line 72: /dev/fd/63: No such file or directory
3014  poda-fuentes.sh: line 73: viejos: unbound variable
3015  ⚠ poda de fuentes falló (rc=1) — sigo
3016```
3017
3018El segundo error es consecuencia del primero (el `mapfile` nunca corrió) y el primero **no nombra la
3019causa**: la sustitución de procesos de bash (`<(...)`) necesita `/dev/fd`, y **una caja takana no lo
3020tiene**. gioser sí: `/dev/fd -> /proc/self/fd`. O sea que no era este script: **ningún `<(...)` de
3021ningún script del hub funcionaba allá**, y éste fue el primero en toparse.
3022
3023Por eso los arreglos son dos, y los dos hacían falta:
3024
30251. **En la caja**: `/dev/fd -> /proc/self/fd`, con una Card **OneShot** en el `genesis` para que
3026   sobreviva al reinicio (como la de `hostname`). Comprobado después:
3027   `bash -c 'cat <(echo funciona)'` responde. ⇒ *lo correcto a futuro es que lo haga el init o el
3028   product-rootfs, no una Card.* Van dos parches de esta forma; es una lista que conviene no alargar.
30292. **En el script**: fuera `<(...)` (fichero temporal) y fuera `df -B1 --output=avail`, que es GNU —
3030   con `df -k` + awk. Sin eso el script corría pero decía **`libres 0.0 G`**, porque el `df` fallaba
3031   en silencio y el 0 se lee como un disco lleno.
3032
3033Con las dos cosas, la poda hizo su trabajo por primera vez en la caja:
3034
3035```
3036   2 árbol(es) por encima del suelo · borrados 2 · libres 46.1 G · LIBERADO 5.4 G
3037```
3038
3039⇒ **En total, 32,2 G recuperados hoy en la caja**: 26,8 G de artefactos superados (§6.44) y 5,4 G de
3040árboles de fuentes. `/store` al 62 %, `/work` al 29 %.
3041
3042### 6.46 🚪 Puerta 5 verde: la caja publica su repo firmado **y se instala de él** *(2026-09-17)*
3043
3044La puerta 5 estaba a medias desde el §5.4 y el motivo era el de siempre: *el host no se puede
3045actualizar de sí mismo porque `install` reproduce desde fuente y eso exige el LAB*. Con el lab ya
3046instalado (§6.43), se cerró en dos movimientos, los dos corridos **en la caja**:
3047
3048**1. Publicar** — con su propia clave de release, la que se mudó el 2026-09-16 a
3049`/root/.config/takana/keys/`:
3050
3051```
3052  ==> ✓ el índice verifica contra ./trust
3053  publicado: 171 con expected_hash anclado, 3 sin ancla. FALLARON: os-release
3054```
3055
3056**2. Instalar de ese repo, en modo estricto** (`--require-signed`, que exige autoría del catálogo
3057verificada y no se conforma con que el `.swm` reproduzca):
3058
3059```
3060  release: trusted (by release)
3061  install duf 0.9.1 ← dist/repo/duf-0.9.1.tkn
3062  deps: resolviendo catálogo para 1 dep(s): go
3063  caché: artefacto ya en el store hash=b3:abb3527d… name=duf
3064  apply OK — source_patch=1 config_edit=0 init_rule=0 file_drop=0
3065  registrado duf (2 fichero(s))
3066```
3067
3068Se instaló bajo `--prefix /tmp/prueba-install` y con `--db` propio, para no tocar el sistema.
3069
3070⚠ **Y el matiz honesto, que vale más que el verde**: el artefacto **ya estaba en el store**, así que
3071el camino que se ejercitó fue *resolver + verificar firma + hidratar*, **no** *reproducir desde
3072fuente*. Lo que el lab destrabó y sí quedó probado aparte es el **hash** (§6.43: cuatro de cuatro
3073iguales a gioser), que era exactamente donde moría antes —«no pude leer el apk db del lab»—. Queda
3074sin ejercitar el caso «paquete que NO está en el store», que en una caja de producción además es
3075discutible que se quiera: un servidor no tiene por qué compilar.
3076
3077⇒ `os-release` es la única receta del perfil que no se pudo publicar; es la que lleva el logo y la
3078identidad de la distro, y su fallo queda anotado para mirarlo aparte.
3079
3080### 6.47 🚪 Las ocho, al cierre del 2026-09-17
3081
3082| # | puerta | estado |
3083|---|---|---|
3084| 1 | arranca takana puro, se entra por SSH | ✅ |
3085| 2 | el store está entero | ✅ **1320 artefactos, 0 vacíos** tras el gc · `/store` al 62 % |
3086| 3 | los cuatro grafos idénticos | ✅ |
3087| 4 | **la granja late en la caja** | ✅ **§6.43** — con el lab pineado; la caja gana por uno en los dos grafos |
3088| 5 | **el repo se sirve y el host se instala de él** | ✅ **§6.46** — 171 paquetes publicados y `install --require-signed` en verde |
3089| 6 | cada dominio vivo responde 200 | ✅ los 8 |
3090| 7 | el respaldo corre desde la caja | ✅ **§6.48** — corrida completa, 0 errores, y **0 artefactos de la caja sin respaldar** |
3091| 8 | lo fósil, anotado y decidido | ✅ |
3092
3093⇒ **LAS OCHO EN VERDE** (§6.48 cerró la última). Lo que separa a esto del borrado de gioser ya no es
3094técnico: es la decisión del usuario, que es como el §6 dice que tiene que ser — a mano, con las ocho
3095en verde, **nunca por automatización**.
3096
3097Y lo que queda vivo en gioser es el trabajo de la mudanza, no servicios: los ~10 G de árboles
3098personales de `/home` sin decidir (§6.35) y el montón de `[[datos]]` que el censo dejó sin decisión.
3099
3100### 6.48 ✅ Puerta 7: el respaldo corre desde la caja — y el parcial que la envenenaba *(2026-09-17)*
3101
3102```
3103  respaldados (manifiesto del Storage Box) : 3686
3104  en el store de la caja                   : 1320
3105  de la caja, NO respaldados               : 0        ← la cuenta que decide
3106  errores y reintentos en la corrida       : 0 y 0
3107```
3108
3109**Las ocho puertas quedan en verde.**
3110
3111#### ⚠ Pero la primera corrida NO terminó, y el motivo vale por sí solo
3112
3113Se cayó **40 veces seguidas con el MISMO fichero**:
3114
3115```
3116  open ".../fonts/dejavu/.rsync-partial/DejaVuSans-Oblique.ttf" failed: No such file… (2)
3117  ..  store: corte de red (rsync 23). Intento 39; reanudo en 60s.
3118  !!  store: 40 intentos y sigue cayéndose. Dejo lo subido y paro.
3119```
3120
3121No era red. Una transferencia interrumpida **el 11 de septiembre** había dejado ese parcial en el
3122destino con el modo del origen —`-r--r--r--`, porque el store es de sólo lectura por diseño— y
3123**ningún intento posterior puede reescribirlo**. El fallo es ETERNO: esa ruta quedaba envenenada
3124para siempre, y el bucle la golpeaba cada 60 segundos llamándola «corte de red». Es exactamente la
3125pared que la cabecera de esa función dice que no hay que golpear cuarenta veces.
3126
3127Dos arreglos, y el segundo importa más que el primero:
3128
31291. **`--chmod=Fu+w`** en el rsync: los ficheros del respaldo quedan escribibles por su dueño, así que
3130   un corte a mitad se RETOMA en vez de trabarse. El precio —no conservar el bit de sólo-lectura en
3131   la copia— es bajo: lo que se respalda es el contenido, y los permisos los reconstruye el store.
31322. **Al `rsync 23` se le dan TRES intentos, no cuarenta**, y al tercero se NOMBRA la causa probable.
3133   El 23 es «some files were not transferred», que tanto puede ser un cable como una pared; tratarlo
3134   siempre como cable es lo que convirtió un fallo permanente en cuarenta minutos de ruido.
3135
3136#### 🪤 Y dos veces el mismo error mío: `pgrep -f <patrón>` se encuentra a SÍ MISMO
3137
3138Para saber si el respaldo seguía vivo usé `pgrep -f respaldo-storagebox`… y el patrón está en la
3139línea de comando del propio `pgrep` (y del `ssh` que lo lanza). Resultado: **decía «sigue corriendo»
3140para siempre**, incluso con el script muerto hacía rato — y el vigía que armé con esa condición
3141nunca podía dispararse. Pasó dos veces en la misma tarde, en las dos máquinas.
3142
3143La forma correcta es el truco del corchete —`ps ... | grep "[r]espaldo-storagebox"`—, que no coincide
3144consigo mismo porque el patrón literal `[r]espaldo` no aparece en la línea del grep. Es hermano del
3145`pkill -f` que mata tu propia shell, ya anotado en las memorias.
3146
3147### 6.49 📋 Lo único que queda: 150 decisiones sobre datos *(2026-09-17)*
3148
3149Con las ocho puertas en verde, de la mudanza no queda trabajo técnico: queda **decidir**. La hoja
3150está en `docs/state/mudanza-decisiones-pendientes.txt` — 150 entradas, **31,9 G**, ordenadas por
3151tamaño, con lo que la herramienta se anima a sugerir por un HECHO entre corchetes y **en blanco lo
3152que sólo sabe el dueño**:
3153
3154```
3155  /home/sergio/.claude         6.8G  [     ]  lo más nuevo: 2026-09-16
3156  /home/sergio/.local          6.2G  [muda ]  lo usa act_runner, tejido, thasnuna
3157  /var/lib/swap                6.1G  [muere]  (es swap)
3158  /home/sergio/.cache          4.3G  [muere]  caché
3159  /var/lib/gitea               1.9G  [     ]  ← ya mudado en el §6.14; la entrada es un fósil del censo
3160  /home/sergio/imm             200M  [     ]  lo más nuevo: 2026-03-23
3161```
3162
3163Se aplica en una pasada con `planear.py --decidir`, que ya no necesita teclas unitarias (§3 bis).
3164
3165⚠ Y la hoja **dice qué no cubre**, porque una lista titulada «lo que falta» que omite 329 G se lee
3166mal: no están `/mnt/vvv` —el monorepo, este repo, el store, `rustup`— ni los servicios y dominios.
3167Lo de `/mnt/vvv` no necesita decisión: **el store está respaldado (puerta 7) y los repos viven en el
3168gitea de la caja**.
3169
3170#### Lo último que se rescató antes de cerrar
3171
3172`/mnt/vvv/gioserv` tenía **26 entradas sin commitear** y su remoto era
3173`/var/lib/gitea/repositories/sergio/gioserv.git` — una ruta LOCAL de la máquina que se borra. Lo
3174commiteado está a salvo (su `HEAD` es el mismo que el del gitea nuevo); lo que no estaba en ningún
3175lado —el `git diff HEAD` completo (`api/main.py`, +92/−23, y 25 borrados) más los 4 no rastreados—
3176quedó en `takana:/work/mudanza-secretos/gioserv-pendiente/`, verificado: **0 ficheros del origen
3177faltan en el destino**.
3178
3179*No se reapuntó el remoto ni se commiteó nada*: cambiar el remoto de un clon ajeno y decidir si ese
3180`api/main.py` se publica es del dueño del repo, no de la mudanza. El `LEEME.txt` del paquete lleva el
3181comando exacto para reapuntarlo.
3182
3183### 6.50 🤖 El agente corre en la caja — y puede construir *(2026-09-17)*
3184
3185Pedido del usuario, y es la condición que él mismo puso para borrar gioser: *«no borramos gioser
3186hasta tenerte corriendo de aquel lado, con capacidad de compilar tawasuyu y las recetas de takana»*.
3187
3188```
3189  $ claude -p "Decí exactamente: CLAUDE CORRIENDO EN LA CAJA"
3190  CLAUDE CORRIENDO EN LA CAJA
3191```
3192
3193Eso es un turno REAL —API, credenciales, respuesta— desde `2.29.29.217`.
3194
3195#### Por qué va enjaulado, y qué se le concedió
3196
3197El CLI es un **ELF glibc de 360 M** (`interpreter /lib64/ld-linux-x86-64.so.2`, `NEEDED libc.so.6`)
3198y la caja es musl: no hay camino nativo. Es el caso del ADR 0015, el mismo de `sergioh-api`. La
3199instancia `claude` declara, y **conviene decir que es ANCHA en vez de disimularlo**: red, `nesting`,
3200y seis directorios —`/opt/takana` (el trabajo), `/work/dev-fs` (lab + zig/go), `/store`,
3201`/root/.claude` (memoria y credenciales), `/root/.ssh` (ro) y el CLI (ro)—. Un agente que construye,
3202commitea y empuja necesita lo mismo que un humano haciendo ese trabajo; lo que la jaula compra es
3203que ese alcance esté **escrito y acotado**, no que sea pequeño.
3204
3205⚠ El `takana` que construye **no se instala adentro**: sale del store, que ya está concedido. Es
3206estático musl y corre igual dentro de una imagen glibc — comprobado (`takana 0.0.1`).
3207
3208#### La caja construye: dos recetas selladas hoy
3209
3210Antes faltaba una pieza que el lab no traía: **`.dev-fs/tools`** (zig 0.13/0.16 y go, 1 G). El
3211primer intento murió con `zig no encontrado en .dev-fs/tools/zig/zig` — la imagen del lab empaqueta
3212`alpine/` y **nada más**. Copiado eso:
3213
3214```
3215  intel-ucode   → sellado: 156 signatures + GenuineIntel.bin (17 MB)
3216  sof-firmware  → sellado: 2 firmware + 8 topologías (IPC3 v2.2, TigerLake)
3217```
3218
3219#### 🧱 Lo que NO funciona, y su rodeo
3220
3221**`takana build` NO corre DENTRO de la jaula**, aunque la instancia declare `nesting = true`:
3222
3223```
3224  bwrap: Can't mount proc on /proc: Operation not permitted
3225```
3226
3227Y no es que el anidamiento esté roto: **un `bwrap --dev-bind / / --proc /proc` a mano SÍ funciona
3228adentro**, con y sin `--unshare-pid`. Lo que falla es el userns anidado que arma el sandbox del
3229build. Probado también con `root = false` —la sospecha que el propio código documenta (§`grants.root`
3230⚠ del 2026-09-03)— y falla igual: no es el remapeo a root.
3231
3232El rodeo que sí anda, y quedó escrito en el lanzador para que el agente lo use:
3233
3234```sh
3235  ssh -p 22022 -i /root/.ssh/github5 root@127.0.0.1 \
3236    'cd /opt/takana && flock -o work/.farm-build.lock takana --store /store build <receta>'
3237```
3238
3239Con eso, **desde dentro de la jaula se selló `sof-firmware`**. El agente vive enjaulado y le pide
3240los builds al anfitrión, que es donde el sandbox del build tiene los permisos que necesita.
3241
3242#### Cómo se entra
3243
3244`claude` en el PATH de la caja (`/usr/bin/claude`), que envuelve
3245`takana qorpa run claude -- env HOME=/root …`. El manifiesto y el lanzador están versionados en
3246`scripts/servidor/`, porque una instancia que sólo existe en la caja se pierde con la caja.
3247
3248⚠ Pendiente menor: la memoria del agente está en `/root/.claude/projects/-mnt-vvv-takana/`, y allá el
3249repo vive en `/opt/takana` ⇒ **el índice por ruta no coincide**. Se resuelve renombrando el
3250directorio a `-opt-takana` o dándole al repo la misma ruta; hasta entonces el agente arranca sin su
3251memoria del proyecto aunque los 733 ficheros estén en disco.
3252
3253### 6.50 bis 🔑 La cuenta necesitaba sus LLAVES, no su contraseña *(2026-09-17)*
3254
3255Creada la cuenta, el primer intento del usuario falló:
3256
3257```
3258  $ ssh -i ~/.ssh/tawasuyu sergio@gioser.net -p 2345
3259  sergio@gioser.net: Permission denied (publickey).
3260```
3261
3262Y era exacto: **el `sshd` de la caja tiene `PasswordAuthentication no`**, así que la contraseña
3263`tawasuyu` sirve para `su` y para la consola, **no para entrar por SSH**. Lo que faltaba era su
3264`~/.ssh/authorized_keys`, que se creó vacío con la cuenta. Copiado el de gioser —dos llaves,
3265`tawasuyu` y `sergio@tatata`— entra:
3266
3267```
3268  $ ssh -i ~/.ssh/tawasuyu sergio@gioser.net -p 2345
3269  ENTRA como sergio en takana · /home/sergio
3270  $ claude -p "…"   →  ENTRÉ POR SSH Y ABRÍ CLAUDE
3271```
3272
3273Dos detalles que hacen que esto se sienta como la máquina de siempre: **`gioser.net` ya resuelve a la
3274caja**, y **la llave de host es la MISMA que la de gioser** (se copiaron en el cutover del gitea,
3275§6.25) — comprobado: `SHA256:ltSl+rgr2Uc…` en las dos. Por eso no aparece el aviso rojo de
3276«REMOTE HOST IDENTIFICATION HAS CHANGED» al entrar al nombre de siempre.
3277
3278⚠ El `sshd` escucha en **22022 y 2345**, los dos generales: `2345` es el puerto que los clones de
3279git ya usaban, y sirve igual para entrar.
3280
3281### 6.50 ter 🧰 `sudo` y el taller: dónde se programa en la caja *(2026-09-17)*
3282
3283**`sudo` no andaba por dos cosas a la vez, y una era el corte de energía.** `/usr/bin/sudo` **no
3284tenía el bit setuid** (`sudo: must be owned by uid 0 and have the setuid bit set`), y además
3285`/etc/sudoers.d/sergio` **había desaparecido**: lo escribí minutos antes del `reset` del §6.51 y se
3286fue con el mismo corte que dejó el cortafuegos en NULs. Repuestos los dos —y con `sync`—,
3287`sudo id` devuelve `uid=0(root)`. `visudo` no está instalado, pero **no hace falta**: el fichero
3288suelto en `/etc/sudoers.d/` es la forma correcta, y `sudo` lo valida solo.
3289
3290⚠ `doas` sigue dando `Operation not permitted` aun estando setuid. No hizo falta perseguirlo —`sudo`
3291resolvió— pero queda anotado como rareza sin explicar.
3292
3293#### Dónde están los repositorios
3294
3295**Los 44 están en la caja**, en el gitea que se mudó el 14-sep: `/var/lib/gitea/repositories/`
3296(`sergio/` 939 M, `tawasuyu/` 547 M). Lo que NO había era un **clon de trabajo**: sólo `/opt/takana`,
3297que es el del hub.
3298
3299```
3300  ~/src  →  /work/sergio          ← el taller
3301  /work/sergio/tawasuyu  478 M    ← clonado, origin al gitea de la caja
3302```
3303
3304⚠ **El taller va en `/work`, no en el home.** La raíz de esta caja tiene **2,4 G libres** y `/work`
3305**43 G**: un clon del monorepo en `/home` llena la raíz y tumba la máquina.
3306
3307⚠ **Y clonar acá tiene dos trampas medidas:**
33081. **El `git` del corpus no tiene `remote-https`** (`git: 'remote-https' is not a git command`), así
3309   que **no se puede clonar por HTTPS** desde la propia caja. Es la deuda ya anotada del §bloqueantes.
33102. Clonar por **SSH** (`ssh://gitea@git.gioser.net:2345/…`) exige que la llave esté registrada **en
3311   la cuenta de gitea**, no basta con el `authorized_keys` del sistema. Hasta que se registre, el
3312   camino es el **sistema de ficheros** (`git clone /var/lib/gitea/repositories/<org>/<repo>.git`) —
3313   con dos detalles: el directorio de cada organización es `0700` del usuario `gitea`, así que hay
3314   que clonar como root y `chown` después; y git rechaza el repo por `dubious ownership` hasta que se
3315   le dice `git config --global --add safe.directory "*"`.
3316
3317Y el agente se abre sobre cualquiera de ellos:
3318
3319```
3320  PROY=/work/sergio/tawasuyu claude
3321  → «Es tawasuyu (/work/sergio/tawasuyu, origin git.gioser.net:2345/…), último commit 55e5f0f27»
3322```
3323
3324### 6.50 quater 📦 Cómo se instala software de tawasuyu en la caja — y por qué NO con `actualizar-servidor.sh` *(2026-09-17)*
3325
3326Pregunta del usuario: *«¿ahí tengo la confianza de `install-tawasuyu` y `actualizar-servidor`? ¿o
3327cómo es la forma de instalar, por ejemplo, `shuma-tui`?»*
3328
3329**Esos guiones existen y siguen ahí** —el monorepo está clonado en `/work/sergio/tawasuyu`— pero lo
3330que hacen es:
3331
3332```
3333  cargo build --release <crates>        …y después…        install -m755 <nuevo> /usr/local/bin/<x>
3334```
3335
3336O sea: **producen exactamente la clase de binario que la mudanza encontró irreproducible** — 2,7 G
3337de sueltos que ningún paquete provee (§6.35), de los cuales tres corrían desde un inodo BORRADO.
3338Además `actualizar-servidor.sh` escribe servicios en `/etc/init.d/`, que en esta caja no existe: el
3339init es arje.
3340
3341#### La forma de acá, hecha de punta a punta con `shuma-tui`
3342
3343```
3344  1. receta      recipes/shuma-tui.toml   — pinneada al commit del monorepo, zig-cc, musl, estática
3345  2. build       takana build             ⇒ b3:f795ee0f… sellado en el store
3346  3. viaja       worker → hub → caja      (rsync del artefacto, que es content-addressed)
3347  4. instalar    ln -s /store/<hash>-shuma-tui/usr/bin/shuma-tui /usr/bin/
3348  5. control     shuma-tui --help  →  contesta
3349```
3350
3351Los pasos 3 y 4 son el atajo honesto de hoy; el camino completo es el del §6.46 —publicar en el repo
3352firmado y `takana install <nombre> --require-signed`—, que ya está probado y es lo que convierte
3353«copiar un binario» en «instalar un paquete».
3354
3355⚠ **El paso 2 NO se puede hacer en la caja todavía**, y el motivo es la deuda ya conocida: su `git`
3356**no tiene `remote-https`**.
3357
3358```
3359  git: 'remote-https' is not a git command
3360  Error: git ["clone","--mirror",…,"https://git.tawasuyu.net/…"] falló
3361```
3362
3363Las recetas del corpus que bajan tarballs con `curl` **sí** construyen ahí (hoy se sellaron
3364`intel-ucode` y `sof-firmware`); las que clonan por HTTPS —todas las de tawasuyu— hay que
3365construirlas en el worker, que sí tiene git completo. Arreglar eso es re-sellar `git` con libcurl, y
3366es raíz de `perfil.base`: unidad propia.
3367
3368### 6.50 quinquies 🔑 Las fuentes git se traen por SSH — y la raíz de 5,9 G tiró la caja entera *(2026-09-17)*
3369
3370El §6.50 quater dejó anotado el muro: la caja no tiene `git-remote-http`, así que las 36 recetas que
3371clonan de `git.tawasuyu.net` —y las ~90 de GitHub— no se podían construir ahí. La salida es la que
3372pidió el usuario: **usar SSH**. Y sale gratis en hashes, porque **la URL es un LOCALIZADOR y no entra
3373en `hash_inputs`** (ADR 0013): el mismo commit por otro transporte sella el mismo artefacto.
3374
3375No se toca ninguna receta —el worker sigue clonando por HTTPS, que es lo que puede— sino la caja:
3376
3377```
3378  git config --global url."ssh://gitea@git.gioser.net:2345/".insteadOf "https://git.tawasuyu.net/"
3379  git config --global url."ssh://git@github.com/".insteadOf        "https://github.com/"
3380```
3381
3382Tres cosas que costaron una vuelta cada una, las tres MEDIDAS:
3383
33841. **`takana` clona bien, pero `cargo vendor` clona aparte.** cargo honra el `insteadOf`, pero usa su
3385   propio cliente SSH: primero se plantó por la clave del host —la tenía como `[git.gioser.net]:2345`
3386   y cargo la busca **sin puerto**, misma clave reexpresada— y después por autenticación, porque no
3387   sabe leer `IdentityFile` de `~/.ssh/config`. Se resuelve delegando en el git de verdad:
3388
3389   ```toml
3390   # ~/.cargo/config.toml
3391   [net]
3392   git-fetch-with-cli = true
3393   ```
3394
33952. **La huella de `github.com` se PINEA, no se acepta a ciegas.** `ssh-keyscan` dio
3396   `SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU`, idéntica a la que GitHub publica, y **por eso**
3397   entró a `known_hosts`. La clave de esta caja autentica como deploy key de otro repo y aun así lee
3398   repos públicos ajenos: comprobado con `uutils/coreutils`.
3399
34003. **Y la que dolió: la raíz son 5,9 G y `cargo` la llenó.** `CARGO_HOME` estaba en `/root/.cargo`, o
3401   sea en `sda2`. El vendor del monorepo bajó 2,7 G, la raíz llegó al **100 %**, y la caja **no se
3402   degradó: se cayó entera** — sin HTTP, sin SSH y **sin responder al ping**, con Hetzner informando
3403   `running`. Hubo que entrar por rescate otra vez.
3404
3405   Lo que el disco lleno deja como rastro, y conviene saber leer:
3406
3407   ```
3408     caddy   → «write error: write /var/log/caddy/requests.json: no space left on device»
3409     mis     → /root/.ssh/config quedó con 105 BYTES NULOS al final: el append entró a medias
3410     escrituras  (el mismo daño que el corte de luz le hizo al reglaset del cortafuegos, §6.51)
3411   ```
3412
3413   **Un `>>` que falla por ENOSPC no deja el fichero como estaba: lo deja extendido y relleno de
3414   ceros.** Es exactamente la clase de avería que el §3 de `CLAUDE.md` describe para los artefactos
3415   vacíos — llega hasta el final diciendo que todo fue bien.
3416
3417**Reparado en el rescate, y las tres piezas son permanentes:**
3418
3419| qué | dónde | por qué |
3420|---|---|---|
3421| `/root/.cargo` → `/work/cargo-home` | symlink | 2,7 G de caché no caben en una raíz de 5,9 G |
3422| poda horaria de logs | `/usr/local/sbin/poda-logs.sh` + cron `17 * * * *` | `ente-gitea.log` había llegado **solo** a 114 M y **nadie lo rotaba** |
3423| `.ssh/config` y `.gitconfig` | reescritos | tenían NULs de las escrituras a medias |
3424
3425Tras el arranque: raíz al **54 %**, los 18 entes corriendo y **los 7 dominios de la caja en 200**
3426(`terapeuta.ec` sigue en gioser a propósito — se decidió respaldar, no mudar).
3427
3428> **La lección, que no es sobre cargo.** La raíz de esta caja es **5,9 G** y todo lo que crece sin
3429> dueño vive ahí: logs, cachés, spool. No hay margen para «ya lo limpio después», y el modo de fallo
3430> no es un error: es la máquina entera apagándose en silencio. Cualquier cosa que acumule bytes en la
3431> caja **se declara dónde vive antes de correrla por primera vez**.
3432
3433#### El control que cierra esto: la caja construyó una receta de tawasuyu de punta a punta
3434
3435`puriy-costura` era la única de las 36 que **no** estaba en el store de la caja — o sea, un fallo de
3436caché de verdad, no un cache-hit disfrazado de éxito ([[cache-congela-regresiones]] es justo esto).
3437La caja la hizo entera y sola: clonó por SSH (111,7 M de mirror), vendoreó, compiló y selló.
3438
3439```
3440  hash que predice el HUB  b3:7d63655aa5fea3cbc08724887617d7f58b325fcb2e00ac050b1937966c2459e6
3441  hash que selló la CAJA   b3:7d63655aa5fea3cbc08724887617d7f58b325fcb2e00ac050b1937966c2459e6
3442  contenido                2,2 M · usr/bin/puriy-costura · corre y muestra su ayuda
3443```
3444
3445**Idéntico**, que es lo único que prueba que el transporte no contamina el artefacto. Con esto la
3446caja cumple la condición que puso el usuario para poder borrar gioser —«con capacidad de compilar
3447tawasuyu y las recetas de takana»— **desde fuente y por su cuenta**, no por artefactos que le llegan
3448del worker.
3449
3450El guion `scripts/servidor/fuentes-por-ssh.sh` deja esto reproducible: idempotente, con la huella de
3451github pineada (si el host anuncia otra, **sale con error en vez de aceptarla**) y con un control
3452final que CLONA de los dos orígenes. Probados sus dos negativos: un repo inexistente lo hace fallar,
3453y una huella cambiada la rechaza.
3454
3455### 6.50 sexies ✅ Pagada la deuda: el `git` del corpus vuelve a clonar por HTTPS *(2026-09-17)*
3456
3457El §6.50 quinquies dejó la caja trayendo fuentes por SSH porque su `git` no tenía `remote-https`.
3458Eso era el síntoma; **la causa estaba un paso antes de donde todos mirábamos** —incluida la nota que
3459yo mismo había escrito, que culpaba al Makefile—.
3460
3461El tarball de git trae `configure`, y takana lo corre. Su test de libcurl es `AC_CHECK_LIB`, que
3462enlaza `conftest.c -lcurl` **y nada más**. Con libcurl **estática** eso no resuelve: faltan
3463`-lssl -lcrypto -lz`, que son sus privadas.
3464
3465```
3466  checking for SHA1_Init in -lcrypto...       yes
3467  checking for curl_global_init in -lcurl...  no      ← acá se decidía todo
3468  checking for XML_ParserCreate in -lexpat... no
3469```
3470
3471El test falla, `config.mak.autogen` se lleva `NO_CURL=YesPlease`, el Makefile excluye
3472`git-remote-http`, `git-http-fetch` y `git-http-push` —**y conserva `git-http-backend`, que es el
3473lado servidor y no usa curl**: esa asimetría en el artefacto era la firma del fallo, y estuvo a la
3474vista desde el 2026-09-14—. El build **termina en verde**. Es el §3 de `CLAUDE.md` en su forma más
3475cara: un ausente falla ruidosamente, un vacío llega hasta el final diciendo que todo fue bien.
3476
3477**La cura, tres líneas en la receta**, cada una con su motivo:
3478
3479| línea | por qué |
3480|---|---|
3481| `LIBS="$(curl-config --libs)"` al `configure` | le da al test lo que el enlace estático necesita — y sale de `curl-config`, no escrito a mano: si curl gana privadas mañana, las trae solo |
3482| guardián sobre `config.mak.autogen` | el modo de fallo es **silencioso** ⇒ se comprueba el HECHO (`NO_CURL=YesPlease`) y se corta, en vez de enterarse meses después |
3483| `NO_EXPAT=1` | con curl encendido el Makefile agrega `http-push.o`, que pide `-lexpat`, y expat no está en deps. `http-push` es el push por WebDAV: clonar y traer no pasa por ahí |
3484
3485**Medido sobre el artefacto, nunca sobre el `git` del host** (`ls $(git --exec-path) | grep remote-http`):
3486`b3:215742cb…` trae `git-remote-http`, `git-remote-https`, `git-http-fetch` y los `ftp`. Y **clona**
3487—no `ls-remote`: `clone`, que es donde murió la vez del ubsan—: árbol en disco y `rev-list` contesta.
3488En la caja, hidratado y con la reescritura a SSH **apagada**, `git clone https://…` funciona, y
3489`git clone --mirror` —el comando exacto que usa `takana build` para traer fuentes— también.
3490
3491> **El radio, medido en vez de temido.** La nota vieja decía que arreglar esto «re-sella `git`, que es
3492> raíz de `perfil.base` ⇒ radio grande». `yupana radio git` dice otra cosa: **cero** dependientes
3493> directos y **cero** transitivos. Toca las 7 imágenes que lo incluyen —que es re-ensamblar, no
3494> reconstruir—. El miedo escrito a mano había sobrestimado el costo de arreglarlo, y eso lo mantuvo
3495> roto tres días.
3496
3497Las reescrituras `url.insteadOf` quedaron **retiradas** de la caja: ya no hacen falta.
3498`scripts/servidor/fuentes-por-ssh.sh` se conserva como salida de emergencia, no como el camino normal.
3499
3500### 6.52 🧩 Las proc-macros SÍ se pueden compilar en la caja — falta un `cc`, no un parche *(2026-09-18)*
3501
3502Con `rust` sellado, la caja compila y corre binarios **estáticos** sin tocar nada. Lo que no compilaba
3503es cualquier **dylib**, y eso incluye **todas las proc-macros** (`serde_derive`, `clap_derive`…), o sea
3504media ecología de Rust:
3505
3506```
3507  ld.lld: error: unable to find library -lgcc_s
3508  ld.lld: error: unable to find library -lc
3509```
3510
3511#### Por qué el `-L` obvio empeora las cosas
3512
3513La reacción natural es darle el camino: `-L /usr/lib`. **Y eso rompe los estáticos**, que hoy
3514funcionan. Cuatro controles lo aíslan:
3515
3516| | enlace | resultado |
3517|---|---|---|
3518| A | estático, sin `-L` | ✅ enlaza — es lo que hay hoy |
3519| B | estático, con `libgcc.a` a la vista | ✅ enlaza — el arreglo de `gcc-libs` no rompe nada |
3520| C | estático, con `-L /usr/lib` + `libgcc.a` | ❌ rompe |
3521| D | estático, **sólo** con `-L /usr/lib` | ❌ rompe ← la culpable |
3522
3523```
3524  ld.lld: error: relocation R_X86_64_32S cannot be used against symbol '__malloc_size_classes';
3525          recompile with -fPIC            ← sale de /usr/lib/libc.a, que NO es PIC
3526```
3527
3528rustc enlaza musl **static-PIE** con su copia *self-contained*; meter `/usr/lib` en el camino le hace
3529preferir la `libc.a` del sistema, que no sirve para PIE. **El camino de librerías no puede ser
3530global: el estático lo quiere fuera y el dinámico lo quiere dentro.** Ningún `RUSTFLAGS` global
3531arregla esto — apaga un caso y enciende el otro.
3532
3533#### Lo que sí funciona, medido de punta a punta
3534
3535Quien sabe distinguir los dos casos es un **driver de C**. La caja no tiene `gcc` ni `clang`
3536—`clang18` en el store son sólo cabeceras y librerías, sin binario— **pero sí tiene `zig`**: el
3537artefacto `seed-zig` del bootstrap trae `zig 0.16.0` y **corre**. `zig cc` es un driver de C completo
3538con musl adentro.
3539
3540```
3541  cc        →  zig cc
3542  RUSTFLAGS →  -C linker=cc -C linker-flavor=gcc -C link-self-contained=no
3543```
3544
3545Las tres banderas hacen falta y cada una por su motivo: `linker`+`linker-flavor` para que el enlace
3546pase por el driver, y `link-self-contained=no` porque si no rustc pide su propio `rust-lld` —que este
3547toolchain **no tiene**, ya que `rust.lld = true` es incompatible con el `llvm-config` externo (§ la
3548receta lo documenta)— y muere con *«the self-contained linker was requested… it wasn't found»*.
3549⚠ La variante fina `-C link-self-contained=-linker` **no sirve**: es inestable en este triple y exige
3550`-Z unstable-options`. La gruesa, `=no`, es estable.
3551
3552Con eso, la cadena completa que nunca había compilado:
3553
3554```
3555  1. la proc-macro            ⇒ libpm.so
3556  2. el programa que la usa   ⇒ imprime «PROC-MACRO VIVA»
3557  3. y el estático de siempre ⇒ sigue enlazando
3558```
3559
3560#### Entregado: `scripts/servidor/cc-por-zig.sh`
3561
3562El envoltorio existe y está puesto en la caja. **No mete nada nuevo en el corpus**: usa el `seed-zig`
3563que YA está en el store —producto del bootstrap (SDD 11), como `stage1-rootfs`— y sólo lo envuelve en
3564`/usr/bin/cc` y `/usr/bin/c++`, más las tres banderas en `/etc/profile.d/`. Volver a zig el
3565compilador de C **oficial** de la distro es otra cosa —ahí sí haría falta receta y pin propios— y es
3566decisión de ADR, no de un guion de puesta a punto.
3567
3568Es idempotente y sus cuatro controles preguntan por el HECHO:
3569
3570```
3571  ✓ C: C en takana                                  ← compila y EJECUTA un hola mundo
3572  ✓ rust: proc-macro: 42                            ← la macro enlaza, el que la usa corre
3573  ✓ rust estático (sin banderas): estático ok       ← el remedio no rompió lo que funcionaba
3574  ✓ entorno: una shell de login trae RUSTFLAGS puesto
3575```
3576
3577Ese último control encontró algo de paso, y es la clase de cosa que este repo persigue: **en la caja
3578`/etc/profile.d` no lo leía NADIE**, porque `/etc/profile` no existía. El fichero de las banderas
3579habría quedado presente, con contenido y sin ningún efecto — y el `bash_completion.sh` que ya estaba
3580ahí llevaba quién sabe cuánto igual de mudo. Se creó el `/etc/profile` con el bucle estándar. La
3581caché de `zig cc` vive en `/work/zig-cache` (54 M) y **no** en la raíz de 5,9 G, por lo aprendido en
3582§6.50 quinquies.
3583
3584### 6.53 🔧 Borré `/usr/bin/id` probando el setuid *(2026-09-18)*
3585
3586Para saber si el bit setuid elevaba en esta caja copié `busybox` sobre **`/usr/bin/id`** —porque
3587busybox elige el applet por `argv[0]` y necesitaba un nombre válido— y después borré «mis» copias de
3588prueba. Una de ellas **era el `id` del sistema**. Resultado, del lado del usuario:
3589
3590```
3591  $ claude --dangerously-skip-permissions
3592  /usr/bin/claude: line 23: id: not found
3593  $ id
3594  -bash: /usr/bin/id: No such file or directory
3595```
3596
3597No quedaba ninguno: `/bin/id` tampoco existía. Se restauró como sus hermanos de identidad —`whoami`
3598y `groups` apuntan a `../../bin/busybox`— y se comprobó con `id` de root, de `sergio` y con el
3599`id -un` que usa el lanzador. Barrido posterior: **0 enlaces colgados** en `/bin`, `/usr/bin`,
3600`/sbin` y `/usr/sbin`, y presentes los ocho comandos de los que dependen el arranque y el lanzador.
3601
3602> **La lección, que es de método:** para probar una propiedad del sistema —¿eleva el setuid?— **no se
3603> usa un nombre que el sistema ya ocupa**. La sonda correcta era la que terminé escribiendo: cinco
3604> líneas de C compiladas con el `cc` nuevo a un nombre inventado (`probe-suid`). Copiar sobre `id`
3605> fue elegir el camino corto, y el camino corto se llevó un binario del que depende hasta el script
3606> que abre al agente. Es la misma familia que el `/etc/shadow` del §6.51: **la caja no avisa cuando
3607> le falta algo esencial — se entera el que lo usa**.
3608
3609### 6.54 🧭 Trabajar DESDE la jaula: lo que el agente de adentro reportó *(2026-09-18)*
3610
3611El agente enjaulado pasó un informe de defectos —el primero hecho **desde adentro**— y vale más que
3612cualquier inspección desde el anfitrión, porque son las cosas con las que se choca al usarla.
3613
3614#### Lo que se arregló, y dónde vive cada arreglo
3615
3616| # | defecto | dónde queda el arreglo |
3617|---|---|---|
3618| 1 | sin entrada en `/etc/passwd` para el uid de adentro ⇒ `ssh`/`git` mueren con *No user exists for uid 1001* | `jaula-preparar.sh` (upper) |
3619| 2 | `/etc/ssh/ssh_config.d` es de la capa inferior, dueño fuera del mapa ⇒ `ssh` **aborta**, no degrada | `jaula-preparar.sh` (upper) |
3620| 3 | `~/.ssh` en `ro` ⇒ `ssh` no puede escribir `known_hosts` | **manifiesto**: pasa a `rw` + semilla desde el anfitrión |
3621| 4 | sin clave para el worker ⇒ `Permission denied (publickey)`, cero granja | clave **propia** de la caja autorizada en el worker |
3622| 5 | sin `rsync`/`python`/`jq`/`b3sum`, y sin `takana` ejecutable | **manifiesto**: `packages`; y un `takana` que sale del store |
3623
3624El **1 y el 2 viven en el `upper`**, que por el D3 es caché descartable: al primer `recreate` se
3625pierden. Por eso existe `scripts/servidor/jaula-preparar.sh`, que los repone —escribiendo como la
3626persona, no como root, para no dejarle ficheros que después no puede tocar—.
3627
3628Sobre el **4**: se autorizó en el worker la clave **de la caja** (`sergio@caja`), no la de root. Es
3629una credencial distinta y revocable: quitarla del `authorized_keys` del worker corta ese acceso sin
3630tocar ningún otro. Comprobado: `ssh root@dev.gioser.net hostname` desde la caja contesta `PruebasIA`.
3631
3632Sobre el **5**: `takana` **no se compila adentro**. El binario es el musl estático del store y corre
3633igual dentro de una imagen glibc; lo que fallaba es que
3634`/opt/takana/target/release/takana` del anfitrión es un enlace a `/usr/bin/takana`, y **adentro
3635`/usr/bin` es el de Arch**. Queda `/work/sergio/bin/takana`, que elige el más reciente del store —no
3636un hash cableado, para que sobreviva a un re-sellado— y el `target/release/takana` del clon apunta
3637ahí.
3638
3639#### Las tres trampas de orientación, que no son defectos pero cuestan una hora
3640
3641- **El store real es `/store`**, 61 G y 1333 artefactos. Los runbooks y el `CLAUDE.md` dicen
3642  `takana build --store ./store` porque están escritos para el HUB; copiado literal en la caja, eso
3643  apunta a un store vacío dentro del clon. Desde la caja va `--store /store`.
3644- **Hay dos checkouts y no son intercambiables**: `/work/sergio/takana` es el de trabajo —suyo, con
3645  push propio—, y `/opt/takana` es el del sistema: el que usan el cron, la granja y los servicios.
3646  Editar el segundo por costumbre es pisarle el árbol al latido.
3647- **`scripts/farm/.fleet` ausente NO es un defecto** —el propio informe lo retiró—: `flota-permanente`
3648  está versionado y `cosecha-cron` lo repone.
3649
3650### 6.55 🔓 «Una sola sesión» es del KERNEL; «un solo Claude» era nuestro *(2026-09-18)*
3651
3652El usuario chocó con `Resource busy` al abrir un segundo agente y lo llamó por su nombre: *«no quiero
3653restricciones arbitrarias»*. Tiene razón en la queja y conviene separar qué es qué, porque las tres
3654cosas se sienten igual desde afuera y son muy distintas:
3655
3656**1. Lo que impone el kernel.** Dos overlays sobre el **mismo `upper`** los niega `overlayfs`, no
3657nosotros: la capa mutable se corrompería. `qorpa` reintenta seis veces y después explica la causa en
3658vez de dejar el error crudo de bwrap. **Eso no se toca.**
3659
3660**2. Lo que era empaquetado nuestro** — y sí se toca: *una instancia por persona*. De ahí salía «un
3661solo Claude». Instancias distintas tienen `upper` distintos y conviven sin problema. Medido: crear la
3662segunda cuesta **0 s y 16 K**, porque la imagen se comparte de sólo lectura.
3663
3664**3. Lo que era un accidente**, y se arregló al encontrarlo:
3665
3666| | estaba | ahora |
3667|---|---|---|
3668| `/var/lib/hammer/qorpa/instances` | `root:root 755` ⇒ una persona **no podía crear su propia instancia** | `root:sergio 2775` (setgid) |
3669| `~/.ssh` en la jaula | `ro` ⇒ `ssh` no escribe `known_hosts` | `rw` |
3670| `/store` en la jaula | `ro` ⇒ el agente lee y **no puede sellar** | `rw` |
3671| `claude` | abría `/opt/takana` siempre | abre `$PWD` |
3672| `/usr/bin/claude` | **copia** congelada del guion | enlace al del repo |
3673
3674⚠ **Y queda un defecto de verdad, que hoy bloquea el punto 2**: aprovisionar una instancia nueva
3675muere con `bwrap: Can't mkdir parents for /run/user/0: Permission denied`. La causa está medida:
3676**esta caja no tiene `/run/user`** —no hay logind— y `qorpa.rs:1542` arma la ruta del runtime dir
3677como `/run/user/<uid>` sin alternativa. `XDG_RUNTIME_DIR` no alcanza: lo honra otra rama del código
3678(`1244`/`1549`), no ésta. Es arreglo en el crate, no en un manifiesto.
3679
3680> ⚠ **ESE PÁRRAFO YA NO DESCRIBE LO QUE PASA — el muro se mudó** *(medido el 2026-09-23)*. Se
3681> reprodujo el escenario **exacto** que describe: instancia recién creada, manifiesto tal como lo
3682> deja `create` (`root = true`), red abierta, `provision` de un paquete. **Pasa bwrap entero** —la
3683> jaula arranca y contesta `uid=0(root)`— y el `/run/user/0` no aparece por ningún lado. Muere
3684> después, en otro sitio:
3685>
3686> ```
3687> error: failed to chown temporary download directory /var/lib/pacman/sync/download-rC58yQ: Invalid argument
3688> error: failed to synchronize all databases (failed to initialize download)
3689> ```
3690>
3691> O sea: el bloqueo de esta sección **está arreglado** (el candidato es `d52824ef`, «los padres que
3692> inventa bwrap eran 0700») y lo que queda es **otra cosa** — el mapa de **un solo id**, que es el
3693> ADR 0015 §NO-resuelve 2, la primera cosa que ese ADR dijo que iba a fallar. `pacman` no puede
3694> chownear su descarga porque adentro existe un id y nada más. El `preflight` ya lo nombra y lo
3695> mide: `newuidmap: open of uid_map failed: Permission denied`, veredicto `LIMITA 1`.
3696>
3697> **La ruta cableada de `qorpa.rs:1542` sigue en el código** —no se tocó—, así que lo que cambió es
3698> el síntoma, no esa línea. Se deja el párrafo de arriba en pie a propósito: tacharlo escondería que
3699> durante cinco días el arreglo se buscó en el crate equivocado.
3700>
3701> **Mientras tanto, en producción las jaulas se CLONAN, no se aprovisionan** — `cp -a upper`, ~1 s y
3702> 169 M, que no depende del mapeo. Lo hace solo `claude-caja.sh`. La consecuencia que muerde: si
3703> alguien corre `qorpa recreate` sobre una jaula de agente, **tiene que volver a clonar el `upper`**
3704> o la jaula vuelve sin `git`, sin `ssh` y sin `python`. Y un detalle que delata que esto viene de
3705> lejos: `b3sum` está declarado en `packages` y **no existe en ninguna jaula**, la plantilla
3706> incluida.
3707
3708⚠ **Y había un SEXTO límite accidental, de esta misma tanda, que tardó cinco días en salir**
3709*(2026-09-23)*. La pregunta llegó otra vez y casi con las mismas palabras: *«¿qué me limita levantar
3710más de 8 claudes, una política random o una arquitectura?»*. Era una política, y de una línea —
3711`claude-caja.sh`, el guardia del bucle que elige instancia:
3712
3713```sh
3714[ "$_n" -gt 9 ] && { echo "claude: hay 8 sesiones abiertas de $_base — cerrá alguna" >&2; exit 1; }
3715```
3716
3717Nada más lo sostenía: el bucle **ya crea la jaula siguiente** cuando encuentra ocupada la anterior,
3718y lo arquitectónico —dos overlays sobre el mismo `upper`— lo resuelve ese mismo clonado. O sea, el
3719punto 2 de arriba estaba resuelto y este número lo volvía a cerrar ocho sesiones más allá.
3720
3721Por qué se escapó al barrido del 18-sep, que es lo que importa: los cinco de la tabla eran
3722**permisos y modos** —`755`, `ro`, una copia congelada—, y se los encontró mirando el borde de la
3723jaula. Éste era un **literal adentro de un `while`**. Un barrido que busca límites accidentales
3724tiene que mirar las dos formas, porque desde afuera se sienten igual.
3725
3726Subido a 10, con el techo real escrito **al lado del número**, que era lo que faltaba. El techo es la
3727RAM, medido acá ese día:
3728
3729| | medido | |
3730|---|---|---|
3731| RAM | 8 sesiones = **2,5 G de RSS** (147–493 M cada una, ~310 M de media) | sobre 7,7 G, con 8 G de swap y 4,1 ya comidos |
3732| Núcleos | load **1,07** con las 8 vivas | no limitan: esperan la API, no CPU — y `taller` ya serializa los `cargo` |
3733| Disco | **169 M** por jaula | la imagen (587 M) se comparte de sólo lectura |
3734
3735Pasado ~14 se empieza a jugar con el OOM, que es el modo de falla documentado
3736(`INFORME-CAIDA-2026-08-17`: la caída fue con ocho adentro). **Un número sin su porqué es lo que
3737hace que la próxima vez se lea otra vez como una ley del sistema** — que es, literalmente, lo que
3738pasó con éste.
3739
3740> **Lo que conviene no confundir.** La jaula restringe al **agente**, no a la persona: `sergio` tiene
3741> `sudo`, entra por ssh y manda en la caja entera. Y dentro de la jaula el alcance es **declarativo**
3742> (D7): lo que no está en `grants` no se ve, pero agregarlo es editar un fichero, no pedir permiso.
3743> Lo indefendible no es que haya límites — es que un límite **accidental** parezca de diseño, que es
3744> exactamente lo que pasó con los cinco de la tabla.
3745
3746### 6.51 🔥 Me dejé afuera de la caja — 20 minutos caída, y tres causas encadenadas *(2026-09-17)*
3747
3748Crear una cuenta de usuario tiró el servidor de producción. Queda escrito entero porque **ninguna de
3749las tres causas era la que parecía**, y las tres siguen ahí para quien venga.
3750
3751#### 1. `/etc/shadow` no existía, y crearlo cerró el SSH de root
3752
3753La caja nunca tuvo `/etc/shadow`: todas las cuentas llevan `x` en `/etc/passwd` y entran por llave.
3754Para darle contraseña a `sergio` creé el fichero con **todas las cuentas bloqueadas (`!`)** y la suya
3755con su hash. Efecto inmediato: **`ssh` de root empezó a dar `Permission denied (publickey)`** con la
3756misma llave de siempre. Este `sshd` **rechaza la llave de una cuenta cuyo hash está bloqueado**.
3757
3758⇒ La forma correcta acá es la vieja: **el hash va en el campo 2 de `/etc/passwd`** y no hay
3759`/etc/shadow`. Así quedó, y así funciona `su - sergio`.
3760
3761#### 2. La caja NO reinicia por ACPI
3762
3763Con el SSH cerrado, `hcloud server reboot` (ACPI) **no hizo absolutamente nada**: arje-zero no
3764atiende esa señal. La web siguió sirviendo como si nada. Para un mantenimiento remoto eso importa:
3765**la única forma de reiniciar esta caja desde fuera es `reset`, que es un corte de energía.**
3766
3767#### 3. Y el corte de energía dejó el cortafuegos a medio escribir — eso fue lo que la aisló
3768
3769Tras el `reset` la caja **arrancaba** —los logs de arje lo probaban: gitea y caddy escribiendo— pero
3770**nadie llegaba**. La causa, encontrada mirando el fichero:
3771
3772```
3773  $ head -c 90 /etc/takana/cortafuegos-entrada.nft | od -c
3774  0000000  \0  \0  \0  \0  \0  \0  \0  \0  \0  \0  \0  \0  \0  \0  \0  \0
3775```
3776
3777**El reglaset era TODO NULs.** Se había escrito minutos antes del corte: ext4 journaló el tamaño y
3778los datos nunca llegaron al disco. Un fichero de 5 KB de ceros — o, peor y más probable en el primer
3779arranque, **medio fichero válido**: la tabla con `policy drop` y las reglas de `accept` cortadas.
3780Eso es exactamente una caja que arranca, corre todo, y no deja entrar a nadie.
3781
3782⇒ **Después de escribir algo que el arranque necesita, `sync` ANTES de cualquier `reset`.** Y el
3783corolario amargo: un `reset` no es un `reboot`, y lo que se perdió no avisa.
3784
3785#### Lo que el rodeo destapó, y vale más que el susto
3786
3787- **El cortafuegos NO se estaba aplicando en ningún arranque.** Su card sale 78 si `nft -c` falla, y
3788  con el fichero corrupto fallaba siempre: la caja llevaba días **arrancando sin filtrar**, en
3789  silencio, porque «no aplicar nada» es su modo seguro y nadie mira un 78 en un log de boot.
3790  Reparado el fichero, ahora el arranque deja **21 reglas `dport`**, comprobado tras un reinicio.
3791- **`netup` es DHCP-only y falló dos veces seguidas** («sin respuesta DHCP (tipo 2)»). Una caja con
3792  IP fija no debería depender de que el DHCP conteste: si no contesta no hay segundo intento, y el
3793  síntoma —desde fuera— es idéntico al de una máquina que no bootea. Se le añadió al init una
3794  **dirección estática de respaldo** con la forma que pide Hetzner (IP `/32` + puerta `scope link`).
3795- **Esa red de respaldo no corría**: su guarda era `[ -d /sys/class/net/eth0 ]` y el init **no monta
3796  `/sys`**. El diagnóstico que lo probó tuvo que escribirse a FICHERO, porque `/dev/kmsg` no
3797  sobrevive al reinicio y sin red no hay forma de mirar. *Cuando no hay red, el log tiene que estar
3798  en el disco.*
3799- Del rescate salió el mapa real de particiones, que no era el que yo creía:
3800  `sda2 hammer-root` · `sda3 hammer-state` · `sda4 hammer-work` · `sdb hammer-store`.
3801
3802#### El costo, dicho sin adornos
3803
3804**~20 minutos de caída** de los ocho dominios, cuatro ciclos rescate↔sistema y tres `reset` duros —
3805uno de ellos, el que corrompió el fichero, disparado por mí a los 400 s de espera **mientras la caja
3806estaba haciendo su trabajo**. La lección que queda no es «hay que tener cuidado»: es que **en esta
3807caja el diagnóstico remoto cuesta un ciclo de 6 a 8 minutos**, así que conviene gastar el primero en
3808dejar evidencia en disco antes que en probar una corazonada.
3809
3810## 7. Reusar los scripts que ya existen, y no escribir de nuevo
3811
3812Pedido explícito del usuario. El inventario de lo que ya hace el trabajo:
3813
3814| para | script existente | qué le falta |
3815|---|---|---|
3816| armar el rootfs de un perfil | `scripts/hydrate-profile.py` | nada — es el camino bueno (los `hydrate-*.sh` por escritorio **divergen** de `targets.toml`) |
3817| producir el `.img` | `scripts/install-image.sh` / `scripts/product-image.sh` | apuntar al `perfil.servidor` |
3818| escribir a disco | `scripts/takana-install.sh` | el envoltorio de rescue del §3.2 |
3819| instalador con TUI | `scripts/takana-live-install.sh` | ser el **mismo motor** que el remoto, con las respuestas por fichero |
3820| provisionar un worker | `scripts/farm/vps-setup.sh` | ya soporta apt **y** dnf; le falta la rama «takana puro» (sin gestor de paquetes ajeno) |
3821| enchufar a la granja | `scripts/farm/.fleet` | **está en `.gitignore`** ⇒ un hub recién clonado nace con la flota vacía **en silencio** |
3822| latido | `scripts/farm/cosecha-cron.sh` | decidir cron vs tarjeta de arje (§3.4) |
3823| respaldo | `scripts/respaldo-storagebox.sh` | nada — es interrumpible y continuable |
3824| absorber el init ajeno | `arje-absorb` | el lector de procesos vivos (§4) |
3825
3826⚠ **Un motor, tres frentes.** La tentación es escribir el instalador remoto aparte del TUI. Ahí es
3827donde divergen: ya pasó con los `hydrate-*.sh` contra `targets.toml`, y con la unidad systemd del
3828worker que quedó vieja mientras el repo estaba al día. La instalación remota tiene que ser **la misma
3829que hace la persona**, grabada en un fichero de respuestas.
3830
3831---
3832
3833## 8. `churay` como instalador centralizado — la dirección, no la decisión
3834
3835El usuario lo planteó el 2026-09-09: **un instalador único, con CLI y TUI**, que sirva para
3836
3837- las **apps de tawasuyu**,
3838- **paquetes sueltos en cualquier distro**, al estilo nix (instalar sin ser root, sin tocar el
3839  sistema anfitrión),
3840- **takana** mismo,
3841- y **`llimphi`**.
3842
3843Encaja con lo que ya hay y por eso vale escribirlo: `takana install` ya resuelve por nombre contra un
3844índice firmado y **ya acepta múltiples orígenes**; `qorpa` ([ADR 0015](adr/0015-imagenes-ajenas.md))
3845ya corre imágenes ajenas enjauladas sobre el mismo kernel; y el vigía de espejos de churay ya corre
3846en cron desde gioser.
3847
3848✅ **DECIDIDO el 2026-09-23 — [ADR 0021](adr/0021-dueno-del-verbo-de-instalar.md).** Las tres
3849preguntas de abajo están contestadas ahí: **takana pone el motor y expone `takana metal
3850{check,survey,install}`; churay pone la cara y lo llama**, consumiendo `survey --json` en vez de leer
3851los discos por su cuenta. La (1) se partía en dos y por eso no se dejaba contestar —para instalar el
3852SISTEMA no se hidrata ni se reproduce: el instalador lleva el rootfs adentro, en RAM—; sigue abierta
3853para *paquetes sueltos en una distro ajena*, que es otro verbo. La (3) no era un problema: lo que
3854corre en el host ajeno es un ELF **estático**, así que su libc no participa.
3855
3856**No se decide acá.** Es un ADR propio, y tiene al menos tres preguntas abiertas antes de escribir
3857una línea: (1) si el instalador «en cualquier distro» hidrata binarios o reproduce desde fuente —la
3858misma pregunta del [SDD 27 §4](27-perfiles-instalables-y-el-instalador.md), y la respuesta puede no
3859ser la misma fuera de takana; (2) quién es el dueño del verbo, si `takana install` crece o si
3860`churay` lo envuelve; (3) qué pasa con un host glibc, que es exactamente lo que el ADR 0015 aparta
3861del store a propósito. Queda anotado para que se **decida**, no para que se descubra a mitad.
3862
3863---
3864
3865## 9. Estado y orden
3866
3867**Decisión del usuario (2026-09-14): la mudanza NO pasa por terceros.** Nada de espejar a GitHub
3868para «tener copia fuera»: la copia fuera **la da la propia mudanza** — en cuanto el gitea vive en la
3869caja nueva, los 26 repos dejan de existir sólo en la máquina que se borra. El objetivo es dejar de
3870pagar dos máquinas, no montar una dependencia más. `scripts/mudanza/espejar-repos.sh` queda como
3871herramienta disponible, no como paso del plan.
3872
3873**Y el worker no necesita credenciales: las fuentes de tawasuyu se sirven por HTTPS público.**
3874Las 23 recetas que apuntaban a `gitea@git.tawasuyu.net` (SSH) pasaron a `https://git.tawasuyu.net/…`
3875— la URL es locator y no entra en `hash_inputs` (ADR 0013), así que se cambió **con control y sin
3876mover un solo ArtifactHash**. Medido en el worker: clona y `git archive` extrae el árbol (155 M) sin
3877ninguna clave. Un usuario propio en gitea sólo haría falta para un repo PRIVADO, y hoy ninguna
3878receta usa uno.
3879
3880### Lo que YA está, y no hay que volver a tocar
3881
3882| | |
3883|---|---|
3884| la caja `takana` (`2.29.29.217`) | arranca takana puro, PID 1 `arje-zero` — §3.8 |
3885| store, grafos, granja, respaldo | puertas 2, 3, 4 y 7 — §6.3, §6.7, §6.8, §6.10 |
3886| repo firmado servido por la caja | §5.1 |
3887| **la imagen del perfil `servidor` con gitea** | **arranca y sirve 200, supervisado por arje** — §6.11 |
3888| **`arjectl` para operar sin reiniciar** | §6.12 |
3889| **el gitea de gioser corriendo sobre takana, con sus datos** | ensayo completo — §6.13 |
3890
3891### Lo que falta para el cutover, en este orden
3892
3893⚠ **La lista de abajo es del 2026-09-11 y los pasos 1-5 YA ESTÁN** (gitea mudado y sirviendo, §6.14;
3894estáticos mudados, §6.18; fósiles barridos, §6.19; `api.sergio` mudado, §6.25; `tawasuyu.net` y
3895`gioser.net` mudados, §6.26; squid, §6.27-28; hora, latido y rotación, §6.29; cortafuegos, §6.31-33).
3896
3897**El estado vigente está medido en el §6.34 (2026-09-16), y es más corto de lo que decía esta lista:
3898queda UN solo vhost sirviéndose desde gioser — `sergio.gioser.net` — y el montón de daemons propios
3899del usuario que ningún paquete provee.** Los pasos 6 y 7 son lo único que sigue abierto.
3900
3901
39021. **Actualizar la caja a la imagen nueva** (gitea + `arjectl` + las cuentas de `[[user]]`).
3903   `takana upgrade` está probado (§6.13 del SDD 27 y §5.4 acá); el `dd` es para provisionar, no para
3904   actualizar — sobrescribe el disco local y re-etiqueta la partición.
39052. **Mudar los datos del gitea**: `sqlite3 … ".backup"` (1,5 s, consistente con el servidor vivo) +
3906   `rsync -aH` de `/var/lib/gitea` y `/etc/gitea`. El corte final se hace con el gitea del origen
3907   **parado**, para que el último snapshot no pierda escrituras.
39083. **Caddy en la caja**: los **6 dominios vivos** del §6.9, con su TLS. Los otros 13 no se mudan.
39094. **DNS**: apuntar esos 6 a la IP nueva. El resto de los clones y remotos no se toca — siguen
3910   resolviendo al mismo nombre.
39115. **Verificar desde fuera**: cada dominio vivo responde 200 contra la IP nueva **y** un `git clone`
3912   real contra el gitea mudado.
39136. **El resto de servicios vivos** del censo (qdrant, squid, act-runner, php-fpm…), por el plan que
3914   `planear.py` ya emite.
39157. **Borrar gioser** — sólo con las 8 puertas en verde, a mano, nunca por automatización (§6).
3916
3917### Bloqueantes conocidos, con su tamaño
3918
3919- **`git` sellado sin `remote-http`** (§6.13): afecta a clonar POR HTTPS *desde* una caja takana, no
3920  al gitea que sirve. Re-sella `git`, raíz de `perfil.base` ⇒ unidad propia.
3921- **Puerta 5** sigue a medias: la caja sirve su repo pero no se instala de él (`install` reproduce y
3922  eso exige el lab entero). No bloquea la mudanza; bloquea «el servidor se sirve a sí mismo».
3923
3924**El volumen del store NO se engancha a la caja hasta que pase la puerta 1** — ya pasó, y el store
3925local de 68,7 G alcanza, así que la mudanza no depende de mover el volumen de gioser.