# boveda — la app de la bóveda de la suite, y **el dueño único** de su base (SDD-BOVEDA §8.5).
#
# ── POR QUÉ ESTA RECETA, Y POR QUÉ RECIÉN AHORA (2026-09-18) ────────────────────────────────────
# `atuq` trae desde el 2026-09-15 la extensión `boveda@atuq.tawasuyu` —la décima— y desde el
# 2026-09-16 el host `puriy-costura` pineado a un commit que SÍ atiende `vault.*`. Con eso el SDD 26
# (§7.quinquies.bis) dio la unidad 12 por destrabada y anunció que «ahora sí se puede escribir el
# guardián de metal porque hay con qué correrlo».
#
# ⚠ **Y no había.** Medido contra el artefacto sellado, en esta máquina, con el binario que va en la
# imagen:
#
#     ← {"id":2,"ok":true,"verb":"vault.status","locked":true,"count":0}
#     ← {"id":3,"ok":true,"verb":"vault.match","locked":true,"items":[]}
#     stderr: puriy-costura: sin bóveda (No such file or directory (os error 2)):
#             los verbos vault.* dirán «cerrada»
#
# El host **nunca abre la bóveda por su cuenta, a propósito**: `sled` toma un lock exclusivo, y el
# proceso que lanza el navegador muere y revive con cada pestaña, así que no es un buen dueño de la
# base. El host le habla al DUEÑO por un socket… y el dueño no estaba en el corpus. O sea que la
# función que el navegador anuncia —insignia, `vault.match`, `vault.fill`— hoy contesta «cerrada»
# en las cuatro imágenes de escritorio, sin un solo error a la vista. Es exactamente la forma de
# fallo que el §7.quinquies describe: ficheros en orden, navegador sin la función.
#
# El dueño es ESTA app: abre la bóveda para su propia ventana y levanta el socket en un hilo para
# el navegador (`atender_al_navegador`), con políticas distintas de cada lado — sin preguntar a
# quien está mirando la ventana, preguntando SIEMPRE a lo que llega de afuera (`PorDialogo`, que
# lanza `shuma-pregunta`; ver `recipes/shuma-pregunta.toml`, sin la cual todo `vault.fill` se
# deniega).
#
# ── LA FORMA DE LA RECETA ──────────────────────────────────────────────────────────────────────
# Es una llimphi GUI del monorepo: el patrón es `mirada-greeter` (winit + wgpu/vello ⇒ `link =
# "dynamic"`, porque EGL/Vulkan/wayland se cargan por `dlopen` en runtime y `crt-static` lo
# impediría) sobre el pin `23a292863`, que es el que ya comparten `puriy-costura`, `shuma-*`,
# `pacha-*` y `tejido`. ⚠ Ese párrafo decía que un pin distinto costaba «otro vendoreo de 2,4 G»:
# es FALSO y está corregido en el bloque `[source]` — el árbol se nombra por RECETA, así que cada
# una paga el suyo con el pin que sea.
name    = "boveda"
version = "0.1.0"
license = "MPL-2.0"

[source]
# ⚠ El pin subió el 2026-09-22 a `cd9acd0d9`, y el arreglo que trae es `4f2b5eac7`: **«el llavero
# falló» se contaba como «no hay identidad»**. Los cinco lectores de `pacha_llavero::SEED_IDENTIDAD`
# hacían `.ok().flatten()`, que aplasta tres estados en dos, y uno de los cinco es JUSTO el que
# pinta esta ventana: `pacha-boveda-llimphi` decía «La bóveda está cerrada. Se abre al entrar a la
# sesión» —verdad si no hay seed sembrada, MENTIRA si el llavero falló, porque entrar a la sesión
# no lo arregla—. `pacha-llavero` gana `SeedDeSesion` (`Hay`/`NoHay`/`Fallo`) con tres textos
# distintos a propósito. Medido en el LXC del worker, que es donde se destapó: `add_key` funciona y
# `keyctl(KEYCTL_SEARCH)` da `ENOSYS` ⇒ con la seed presente en `/proc/keys` la app igual decía que
# no había (SDD 26 §7.terdecies).
# ⚠ El pin ya NO es propio: `cd9acd0d9` es también el de `pacha`/`pacha-secretos`. Lo que esta
# receta pide del commit es estar por encima de `eed3120b6` —donde llimphi aprende a pasarle el
# display handle a wgpu; sin eso el binario sella, arranca y NO ABRE VENTANA, con un «index out of
# bounds» que no nombra nada de esto (§7.septies)—, y `cd9acd0d9` lo está, así que el commit propio
# dejó de hacer falta.
# ⚠⚠ Y ACÁ SE CORRIGE UNA PREMISA QUE ESTA RECETA REPITIÓ TRES VECES: **compartir commit NO
# comparte el árbol de fuentes, así que no ahorra ningún vendoreo.** El árbol es
# `work/sources/<NOMBRE DE RECETA>-<commit>` (`crates/takana-build/src/fetch.rs`, el `format!` de
# `{}-{}`), y encima se BORRA y se rehace en cada build (`remove_dir_all` antes del `git archive`).
# O sea que cada receta paga su copia del monorepo y su `cargo vendor` SIEMPRE, con el pin que sea.
# Ya estaba medido y en CLAUDE.md §3 bis, con estas dos recetas de ejemplo: `boveda` y
# `shuma-pregunta` en el MISMO `b80f7567…` ocupaban 2,7 G **cada una**. Lo que sí se comparte es el
# `CARGO_HOME` del hub —`cargo vendor` corre fuera del sandbox—, o sea la DESCARGA; la copia de
# 2,4 G al árbol, no. El motivo para subir el pin es el arreglo de arriba y nada más.
# ⚠ `cd9acd0d9` es el commit donde el `Cargo.lock` cierra de verdad: repone la arista `rpassword`
# de `agora-cli`, que un merge de import (`338d4a9b9`) había resuelto quedándose con el lado viejo.
# Sin ella `cargo vendor --locked` muere con «cannot update the lock file» sin nombrar el crate.
# Y ojo con cómo se cierra ese lock: la operación mínima documentada (`cargo metadata` sin
# `--locked`) corrida en una jaula con el registro INCOMPLETO devuelve 0 y deja un lock al que le
# faltan dos miembros del workspace — y su diff se ve MÁS mínimo que el correcto. Se cierra donde
# el registro está completo; acá, en el worker.
# Los pines anteriores: `b80f7567c` (2026-09-18, §7.octies: el dueño atendía de a UN cliente y con
# el navegador abierto la bóveda quedaba MUDA) y `6f0408d40` (2026-09-21, §7.undecies: una bóveda
# que NO abrió le levantaba el socket al navegador igual, sobre la temporal
# `/tmp/boveda-sin-abrir-<pid>` ⇒ `vault.status` contestaba `locked:false` y un `vault.save`
# consentido se perdía con el proceso). Las dos recetas se mueven JUNTAS porque son las dos mitades
# de la MISMA función —el dueño y el diálogo de consentimiento—, no por compartir nada en disco.
repo   = "https://git.tawasuyu.net/tawasuyu/tawasuyu.git"
commit = "3bfb9799b8fd26bbe151008e6060f6f74b0f3c6b"
# tawasuyu COMMITEA su propio `vendor/` (smithay parcheado por `[patch.crates-io]` POR RUTA); el
# `cargo vendor` de takana lo pisaría y el error hablaría de un crate cualquiera, no de esto.
# No entra en `hash_inputs`.
cargo_vendor_dir = ".hammer-cargo-vendor"

[build]
compiler = "zig-cc"
target   = "x86_64-linux-musl"
link     = "dynamic"
flags    = ["-p", "pacha-boveda-llimphi", "--bin", "boveda"]

# Fase `compile` EXPLÍCITA —réplica de la que takana genera para Cargo— porque hay que inyectar
# `LOCKSTEP_XML_PATH` ANTES del build. La causa está escrita entera en `mirada-greeter.toml` y es
# la misma acá, con el mismo `accesskit_winit` 0.33 y el mismo `zbus-lockstep-macros` 0.5.2 en el
# lock: su `#[validate]` escanea el dir `xml/` de `atspi-common` llamando `.extension().expect()`
# en CADA entrada ⇒ PANICA en el subdirectorio `xml/schemas/`. Apuntando la variable a un dir con
# sólo los `.xml` se evita.
#
# ⚠ La ruta NO es `vendor/` como en `mirada-greeter`: con `cargo_vendor_dir` los crates vendoreados
# caen en `.hammer-cargo-vendor/`. Y la comprobación es a GRITOS: si mañana `atspi-common` deja de
# vendorearse ahí, un `cp` que falla en silencio dejaría la variable apuntando a un dir vacío y el
# panic volvería con el error lejos de la causa.
[build.phases]
compile = '''
set -e
XMLDIR="$PWD/.atspi-lockstep-xml"
mkdir -p "$XMLDIR"
ls .hammer-cargo-vendor/atspi-common/xml/*.xml >/dev/null 2>&1 || { echo "no hay .hammer-cargo-vendor/atspi-common/xml/*.xml — ¿cambió el vendoreo o la versión de atspi? sin esto zbus-lockstep-macros panica en xml/schemas/" >&2; exit 1; }
cp .hammer-cargo-vendor/atspi-common/xml/*.xml "$XMLDIR"/
export LOCKSTEP_XML_PATH="$XMLDIR"
printf '%s\n' '#!/bin/sh' 'for a do' 'case "$a" in --target=*) a=--target=x86_64-linux-musl ;; esac' 'set -- "$@" "$a"' 'shift' 'done' 'exec zig cc -mcpu=baseline "$@"' > "$PWD/.hammer-zig-cc"
chmod +x "$PWD/.hammer-zig-cc"
RF="-C linker=$PWD/.hammer-zig-cc"
rustc -vV | grep -q 'host: .*-alpine-' || RF="$RF -C link-self-contained=no"
CC="$PWD/.hammer-zig-cc" RUSTFLAGS="$RF" cargo rustc --release --locked --offline -p pacha-boveda-llimphi --bin boveda -- -C target-feature=-crt-static
'''
install = '''
set -e
test -x target/release/boveda || { echo "no hay target/release/boveda — ¿cambió el nombre del bin en pacha-boveda-llimphi?" >&2; exit 1; }
install -Dm755 target/release/boveda /out/usr/bin/boveda

# ── EL LANZADOR, Y POR QUÉ ES PARTE DE LA FUNCIÓN Y NO UN ADORNO (2026-09-21) ─────────────────
# Sin esta entrada la app viaja en la imagen y **no existe para quien la usa**: los lanzadores de
# los cuatro escritorios leen `/usr/share/applications`, y a un binario que nadie lista sólo se
# llega escribiendo `boveda` en una terminal. Sería exactamente la forma de fallo que esta receta
# existe para cerrar —la función instalada, apagada y en silencio (SDD 26 §7.sexies)— una capa más
# arriba: la bóveda declarada en el perfil, la insignia del navegador vacía, y nada que falle.
#
# `Icon=dialog-password` es nombre del icon naming spec y está MEDIDO en los tres temas que los
# perfiles declaran, no supuesto: `breeze-icons` 6 ficheros, `adwaita-icon-theme` 1, `cosmic-icons`
# 2. El cuarto perfil (sway) lleva sólo `hicolor`, que por diseño no trae iconos: ahí el lanzador
# cae al genérico, que es degradarse, no romperse.
#
# No lleva `StartupWMClass`, y la razón es que NO HACE FALTA — no que no se pueda. `llimphi_ui`
# arma la ventana con `with_name`, que en Wayland es el `app_id` del xdg-toplevel: usa el
# `App::app_id()` que la app declare y, si no declara ninguna —que es el caso de `BovedaApp`—, cae
# al **nombre del ejecutable** (`app_id_del_ejecutable`, el piso que llimphi se puso cuando 163 de
# sus 178 apps compartían el genérico del compositor). O sea `app_id = "boveda"`, que es
# exactamente el basename de este `.desktop` ⇒ el emparejamiento estándar ya funciona.
# Medido, no leído: el guardián de metal espera `'"app_id": *"boveda"'` en el árbol de sway y lo
# encuentra a los 12-13 s (SDD 26 §7.novies).
# ⚠ Lo que sí sigue mal es el TÍTULO: `App::title()` devuelve `"llimphi"` por defecto y `BovedaApp`
# no lo sobrescribe, así que la barra y el conmutador de ventanas dicen «llimphi». Es de llimphi/la
# app, no de esta entrada.
mkdir -p /out/usr/share/applications
cat > /out/usr/share/applications/boveda.desktop <<'DESKTOP'
[Desktop Entry]
Type=Application
Name=Bóveda
Name[en]=Vault
GenericName=Gestor de contraseñas
GenericName[en]=Password Manager
Comment=Tus contraseñas, y quien las pide tiene que preguntarte
Comment[en]=Your passwords, and whoever asks has to ask you
Exec=boveda
Icon=dialog-password
Terminal=false
Categories=Utility;Security;
Keywords=contraseñas;claves;bóveda;passwords;
StartupNotify=true
DESKTOP
chmod 0644 /out/usr/share/applications/boveda.desktop
test -s /out/usr/share/applications/boveda.desktop || { echo "boveda.desktop quedó vacío" >&2; exit 1; }
'''

[deps]
# Las mismas que `mirada-greeter` menos `linux-pam` (eso era de `auth-core`, que esta app no usa:
# su segundo factor es `nakui-auth`, Rust puro). El stack gráfico se consulta en build-time por
# pkg-config y se carga por `dlopen` en runtime.
build = ["mesa", "wayland", "wayland-protocols", "libdrm", "expat", "zlib", "zstd", "libffi", "pkgconf"]