Sergio
1fcad3f6de
La pregunta era «nuestro propio envoltorio en vez de zen». La respuesta tiene tres hallazgos que cambian el precio, y el documento los pone antes que la lista de features. 1. NO HAY ENVOLTORIO FUERA DEL CHROME. Gecko no tiene API de embebido en escritorio desde que murió XULRunner (GeckoView es Android) ⇒ una carcasa Llimphi con el motor adentro no es posible. El envoltorio es chrome-level o no es. Que es exactamente lo que Zen es. 2. ARTEFACTO DERIVADO, NO FORK DE FUENTE. Si atuq parchea el árbol, cada iteración de UI cuesta cuatro horas de Gecko y el diseño de chrome es iterativo por naturaleza. Como no distribuimos un binario sino que sellamos artefactos, atuq puede depender de `firefox` e inyectar marca, prefs, policies.json y omni.ja encima: itera en segundos, no mueve el ArtifactHash del corpus, y hereda las CVE gratis — que es lo que hundió a los forks de Firefox. Con sus dos gotchas escritos: el omni.ja es un zip y hay que re-empacarlo determinista, y sin invalidar el startup cache el overlay PARECE no agarrar. 3. LAS OPTIMIZACIONES NO SON UN FLAG, SON UNA TOOLCHAIN. PGO/LTO/BOLT son cadena de clang en Gecko, y el corpus no tiene clang usable como compilador: clang18.toml compila SÓLO libclang.so (para bindgen) y llvm18 se selló con PROJECTS="". La unidad real es una receta llvm-toolchain con clang+lld+libc++ musl — la misma pieza que resuelve el muro 3 de firefox.toml. Es la mayor palanca del frente, y por eso encabeza el plan. Lo que NO se promete va escrito ANTES de la lista de features, con el criterio del modelo de adversario de qullqa: atuq no es Tor Browser y no va a tener «modo Tor» — es un binario único en el mundo (musl, wayland-only, branding propio), así que salir por Tor desde acá identifica MÁS, no menos. Se ofrece proxy por contenedor, que es separación de tráfico y no anonimato. Los diferenciadores van con una columna «quién más lo tiene» para no contarnos un cuento: sct (transparencia de scripts, BLAKE3 + testigo) no lo tiene nadie y ya está escrito en tawasuyu; torrent SÍ lo tiene Vivaldi, y lo nuestro sólo vale por dónde cae lo bajado (el CAS). Todo lo que no es CSS pasa por UNA costura: un host de native messaging en Rust. Y atuq no abandona a puriy: el host, el testigo y el archivo con RAG son agnósticos del motor, así que cuando puriy madure se enchufan del mismo lado. atuq es su andamio, no su desvío.
50 lines
3.4 KiB
Markdown
50 lines
3.4 KiB
Markdown
# 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](00-vision.md) | Por qué existe, qué problema resuelve, la actitud de ingeniería |
|
|
| 01 | [Arquitectura general](01-architecture.md) | El modelo de dos mundos, componentes, flujo de datos |
|
|
| 02 | [El laboratorio de build](02-build-lab.md) | Sandbox, `zig cc`, recetas, CAS, grafo de dependencias |
|
|
| 03 | [Hidratación y store](03-hydration.md) | Store content-addressed, hardlinks a FHS, patchelf, rollback |
|
|
| 04 | [Overlay de experimentación](04-overlay.md) | overlayfs en caliente, try/commit/discard |
|
|
| 05 | [Diario de mutaciones](05-journal.md) | fanotify, log append-only, config-sin-ser-declarativa |
|
|
| 06 | [Formato `.swm`](06-swm-format.md) | Manifiesto de mutación compartible, esquema, firma |
|
|
| 07 | [Bus de init y de agente](07-agent-bus.md) | `/run/init.control`, `/run/agent.sock`, protocolo |
|
|
| 08 | [Integración de la IA](08-ai-integration.md) | El bucle agéntico, seguridad, intención → `.swm` |
|
|
| 09 | [Modelo de confianza](09-trust-model.md) | Reproducibilidad, verificar-no-confiar, log de transparencia |
|
|
| 10 | [Roadmap](10-roadmap.md) | Fases, MVP, primer entregable |
|
|
| 11 | [Bootstrap from-scratch](11-bootstrap.md) | Track posterior: Stage 0/1/2, auto-alojamiento, semilla pinned |
|
|
| 12 | [`arje` como init real del Stage 1](12-init-real.md) | Contrato de runtime: seed card, hammerd supervisado, `CRASHED` real |
|
|
| 16 | [harkaq: la jaula de hammer](16-harkaq-jaula.md) | Landlock+seccomp sobre el bwrap actual; política = clausura; evidencia negativa de hermeticidad |
|
|
| 26 | [`atuq`: el envoltorio Gecko](26-atuq-envoltorio-gecko.md) | 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](runbooks/stage1-vm-boot.md) | `stage0`→`stage1`→initramfs→QEMU; criterios de éxito y troubleshooting |
|
|
|
|
## Architecture Decision Records (ADR)
|
|
|
|
Decisiones tomadas, con su contexto y consecuencias. Ver [`adr/`](adr/).
|
|
|
|
| # | Decisión |
|
|
|---|---|
|
|
| 0001 | [Rust para el tooling y daemons](adr/0001-rust-for-tooling.md) |
|
|
| 0002 | [Validar sobre Alpine antes de la distro propia](adr/0002-alpine-first.md) |
|
|
| 0003 | [`zig cc` como compilador por defecto del lab](adr/0003-zig-cc-builder.md) |
|
|
| 0004 | [No escribir nuestro propio Nix](adr/0004-no-custom-nix.md) |
|
|
| 0005 | [Hidratación por hardlinks](adr/0005-hardlink-hydration.md) |
|
|
| 0006 | [Commits fijados, no HEAD vivo](adr/0006-pinned-commits.md) |
|
|
| 0007 | [`arje` como init propio del track posterior](adr/0007-arje-como-init-propio.md) |
|
|
| 0008 | [Bootstrap en 3 stages, `zig` como semilla](adr/0008-bootstrap-stages.md) |
|
|
| 0009 | [Código direccionado por contenido (estilo Unison)](adr/0009-content-addressed-code.md) |
|
|
| 0010 | [Arranque por grafo: el menú de boot como navegación del grafo](adr/0010-arranque-grafo-mirada.md) |
|
|
| 0011 | [Etapa Escritorio: campaña KDE Plasma 6](adr/0011-escritorio-kde-plasma.md) |
|
|
| 0012 | [El árbol de fuentes es caché y workspace a la vez — **PENDIENTE, dilema abierto**](adr/0012-arbol-de-fuentes-compartido-vs-privado.md) |
|