sergio
e570c6ca6f
Errores detectados al auditar afirmaciones técnicas contra el código: 1. minga-vfs: NO está relacionado con Mónadas (esas son de akasha). Es FUSE que proyecta el índice de minga (git semántico) como filesystem, resolviendo paths virtuales a blobs por hash. 2. protocol/SDD.md: Card tiene 19 campos, no 6. Añadido bloque con anatomía completa del struct. 3. STATUS.md: LOC por capa corregidos contra wc -l real - protocol: 6,260 → 7,278 - init: ~3,600 → 4,301 - compat: ~5,000 → 3,435 (estaba sobrestimado) 4. pineal: 6 stubs (<30 LOC c/u), no 5. Export (23 LOC) también es stub funcional. LOC reales por sub-crate documentados. 5. init/SDD.md: ente-soma es wrapper de 44 LOC, no ~30. 6. akasha/SDD.md: fastembed está detrás de feature `embeddings`, ort es transitivo. Sin feature, akasha-nous-real es stub mínimo. 7. vista/barra: LOC ajustados (vista-core 177, barra-core 108). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
37 lines
1.6 KiB
Markdown
37 lines
1.6 KiB
Markdown
# init/ — Init (PID 1) y encarnación Linux
|
|
|
|
**Propósito.** `ente-zero` arranca como PID 1 del fractal. Provee el
|
|
bucle primordial (reap + bus + handshake), bootstrap del kernel
|
|
surface, encarnación de Cards en procesos aislados con namespaces +
|
|
cgroups, y snapshot/restore del grafo.
|
|
|
|
## Crates
|
|
|
|
| crate | tipo | rol |
|
|
| ---------------- | ------- | ----------------------------------------------------- |
|
|
| `ente-zero` | binario | PID 1: reap + handshake server + bus dispatcher |
|
|
| `ente-kernel` | lib | `bootstrap_kernel_surface`, subreaper, SIGCHLD/uevent |
|
|
| `ente-soma` | lib | Wrapper 44 LOC sobre `ente-incarnate` (compat API) |
|
|
| `ente-incarnate` | lib | `clone(2) + namespaces + cgroup + rlimits + cpu` |
|
|
| `ente-snapshot` | lib | `FractalSnapshot` JSON: checkpoint del grafo Cards |
|
|
|
|
## Dependencias
|
|
|
|
- `ente-kernel` ← `nix`, `libc`, syscalls Linux puras.
|
|
- `ente-incarnate` reusable: shuma (sandboxes) y supervisores no-PID-1.
|
|
- Consume `protocol/` (handshake server, brahman-net opcional).
|
|
|
|
## Boot path
|
|
|
|
1. Kernel pasa control → `ente-zero` arranca como `/sbin/init`.
|
|
2. Levanta sockets: `/run/brahman/bus`, `/run/brahman/handshake`.
|
|
3. Lee `Card` semilla (`seeds/arje-{minimal,host,prod}.card.json`).
|
|
4. Para cada `genesis` child Card: `incarnate(card)` → spawn aislado.
|
|
5. Reap loop atiende SIGCHLD; bus loop atiende anuncios/invokes.
|
|
|
|
## Estado
|
|
|
|
Funciona bare metal + QEMU + initramfs (ver `docs/arje-boot.md`). LOC
|
|
~2.2K en init core. Pendiente: cobertura de tests sobre snapshot
|
|
restore en escenarios con stale fds.
|