Files

T

sergio e570c6ca6f docs: fix factual errors en SDDs y STATUS/ROADMAP

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>

2026-05-19 17:03:05 +00:00

1.6 KiB

Raw Blame History

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

Kernel pasa control → ente-zero arranca como /sbin/init.
Levanta sockets: /run/brahman/bus, /run/brahman/handshake.
Lee Card semilla (seeds/arje-{minimal,host,prod}.card.json).
Para cada genesis child Card: incarnate(card) → spawn aislado.
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.

1.6 KiB Raw Blame History