Files
brahman/crates/init/SDD.md
T
sergio 550c98f275 refactor(monorepo): reorganización lógica + renames + SDDs + split CHANGELOG
Reorganización física de crates/:
- core/ (mezclaba 6 propósitos) se divide en protocol/, init/, runtime/, compat/
- shared/ (3 crates) se redistribuye en protocol/ e init/
- lapaloma (sub-módulo de ui_engine) se promueve a modules/pineal/

Renames de proyectos:
- shipote → shuma (runtime de sandboxes)
- nouser → akasha (explorador de Mónadas)
- yahweh → nahual (motor GPUI, antes ui_engine/)
- lapaloma → pineal (data-viz agnóstica)

Fraccionamiento UI → core agnóstico:
- vista-core (DeckState + snap, 175 LOC, 5 tests verdes)
- barra-core (Task + render_html + sanitize, 90 LOC, 5 tests verdes)
- vista-web y barra-web ahora son thin DOM bindings

Documentación nueva:
- 16 SDDs por subdirectorio (≤80 LOC c/u): protocol/init/runtime/compat
  + 10 módulos + apps/
- docs/STATUS.md con cifras reales por proyecto
- docs/ROADMAP.md con plan a finalización (6 hitos, ~6-8 semanas)
- CHANGELOG.md particionado en docs/changelog/<proyecto>.md (7 buckets)

Automatización:
- scripts/reorg.py — script idempotente que: git mv directorios, renombra
  package names, recomputa path = refs, reescribe imports rust, actualiza
  workspace Cargo.toml. Soporta --dry-run.
- scripts/split-changelog.py — particiona CHANGELOG por componente.

Validación:
- cargo check --workspace pasa (124 crates + 2 nuevos cores).
- 10 tests adicionales (5 en vista-core + 5 en barra-core) verdes.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-19 14:48:34 +00:00

1.6 KiB

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 Shim sobre ente-incarnate (compatibilidad legacy)
ente-incarnate lib clone(2) + namespaces + cgroup + rlimits + cpu
ente-snapshot lib FractalSnapshot JSON: checkpoint del grafo Cards

Dependencias

  • ente-kernelnix, 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.