SergioandClaude Opus 5
153725bf82
De 105 pendientes a 87. Cuatro de las cinco recetas que más candidatos arrastraban ya están cerradas (ffmpeg, obs-studio, xwayland, nodejs, pipewire). Las 8 de nodejs son todas BUNDLEADAS, y no se dio por bueno el comentario de la receta: se listó el propio node-v24.18.1.tar.gz y ahí están, deps/googletest, deps/histogram, deps/llhttp, deps/merve, deps/nbytes, deps/simdjson, deps/uvwasi. simdutf es la excepción que confirma que mirar sirve — NO está en deps/ de primer nivel sino en deps/v8/third_party/simdutf, que es exactamente el fichero que la receta parchea para apagar el kernel AVX-512. ⚠ CAPACIDAD AUSENTE, y más honda que la perilla: ldacbt, libfreeaptx y liblc3 son los codecs de audio Bluetooth (LDAC de Sony, aptX de Qualcomm, LC3 de LE Audio). Caen por -Dbluez5=disabled, pero el hecho de fondo es que NO HAY receta de bluez en todo el catálogo: la distro no tiene Bluetooth, ni de audio ni de nada. Eso conviene que esté dicho acá y no descubierto por alguien que enchufa unos auriculares. ⚠ SEGUNDO Y TERCER DESFASE DE VERSIÓN del barrido (el primero fue openapv/ffmpeg): libebur128 y spandsp no aparecen en NINGÚN fichero de pipewire 1.2.7, que es la que la receta pinea. Salen de una expresión de nixpkgs para una pipewire más nueva. Van como 'opcional' y no 'nix-ismo' a propósito, igual que openapv: mandarlas al descarte del sembrador las haría invisibles el día que subamos de versión, que es justo cuando vuelven a ser una pregunta legítima. El resto de pipewire son perillas apagadas a mano y verificadas contra su meson_options.txt: libffado:350 (audio FireWire), libcamera:180, libmysofa:229 (HRTF de audio espacial), lv2:261 (lilv, el host de plugins) y roc:237 (audio en tiempo real por red). Nota sobre el commit anterior: dije que convenía normalizar guiones y mayúsculas en seed-graph.py. Medido después — normalizando nombre de candidato contra el campo `name` de las 1141 recetas, de los 105 pendientes CERO son ese caso. nlohmann_json y libxfont_2 eran los únicos. Sigue siendo buena profilaxis, pero no hay backlog que la pague: no se toca el sembrador por ahora. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LCt3ettR4Z7b6wPCBmbvEV
Documentación de diseño de hammer
Estos documentos son la fuente de verdad del diseño. El código los implementa; cuando haya discrepancia, o se corrige el código o se actualiza el SDD con un commit que explique por qué.
Software Design Documents (SDD)
| # | Documento | Qué cubre |
|---|---|---|
| 00 | Visión y filosofía | Por qué existe, qué problema resuelve, la actitud de ingeniería |
| 01 | Arquitectura general | El modelo de dos mundos, componentes, flujo de datos |
| 02 | El laboratorio de build | Sandbox, zig cc, recetas, CAS, grafo de dependencias |
| 03 | Hidratación y store | Store content-addressed, hardlinks a FHS, patchelf, rollback |
| 04 | Overlay de experimentación | overlayfs en caliente, try/commit/discard |
| 05 | Diario de mutaciones | fanotify, log append-only, config-sin-ser-declarativa |
| 06 | Formato .swm |
Manifiesto de mutación compartible, esquema, firma |
| 07 | Bus de init y de agente | /run/init.control, /run/agent.sock, protocolo |
| 08 | Integración de la IA | El bucle agéntico, seguridad, intención → .swm |
| 09 | Modelo de confianza | Reproducibilidad, verificar-no-confiar, log de transparencia |
| 10 | Roadmap | Fases, MVP, primer entregable |
| 11 | Bootstrap from-scratch | Track posterior: Stage 0/1/2, auto-alojamiento, semilla pinned |
| 12 | arje como init real del Stage 1 |
Contrato de runtime: seed card, hammerd supervisado, CRASHED real |
| 16 | harkaq: la jaula de hammer | Landlock+seccomp sobre el bwrap actual; política = clausura; evidencia negativa de hermeticidad |
| 26 | atuq: el envoltorio Gecko |
Navegador propio como artefacto DERIVADO de firefox (no fork de fuente); la toolchain clang como puerta de PGO/LTO; qué se promete y qué no |
Runbooks (operativos)
| Runbook | Para qué |
|---|---|
| Validar Stage 1 booteando en QEMU | stage0→stage1→initramfs→QEMU; criterios de éxito y troubleshooting |
Architecture Decision Records (ADR)
Decisiones tomadas, con su contexto y consecuencias. Ver adr/.