sergio
8592bab19e
- crates/core/README.md: agrupamiento lógico de los 31 crates absorbidos
de arje (ente-*) y del protocolo brahman (brahman-*) en 6 grupos —
Init/PID 1, contratos, discovery, IPC+CAS, cerebro, 14 shims compat
systemd. No se movieron crates físicamente (rompería paths
cross-workspace).
- seeds/arje-minimal.card.json: PID1 + /bin/sh, smoke test QEMU.
- seeds/arje-prod.card.json: PID1 + 14 shims compat + tmpfiles/binfmt
one-shots + echo + getty (16 children). Validados con
brahman_card::Card::validate.
- seeds/validate.sh: carga la seed vía ente-zero en dev mode.
- scripts/build-arje-initrd.sh: empaqueta CPIO+gzip newc layout
/init→/sbin/ente-zero, /usr/sbin/ente-*-compat, /ente/seed.card.json,
/bin/{sh,...} (busybox o glibc+ldd). Tested: produce 20 MB initrd OK.
- scripts/run-arje-qemu.sh: qemu-system-x86_64 con KVM auto-detect,
-kernel/-initrd/-append "rdinit=/init console=ttyS0,115200 panic=10".
- docs/arje-boot.md: doc end-to-end — layout initramfs, QEMU (con kernel
del host o externo), GRUB bare metal, Proxmox/libvirt args:, schema
de Card con todas las validaciones, debugging (sockets de
introspección, snapshot/restore, metrics), checklist pre-deploy.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
crates/core/ — Init Arje (absorbido) + Protocolo Brahman
El directorio agrupa dos linajes que se fusionaron al absorberse arje dentro del workspace de brahman:
| linaje | prefijo | función |
|---|---|---|
arje |
ente-* |
Init (PID 1), encarnación Linux, compat systemd |
brahman |
brahman-* |
Tarjeta canónica, handshake, broker, admin |
No están en sub-carpetas físicas porque el workspace declara los paths uno
a uno en Cargo.toml raíz y muchos Cargo.toml hijos usan path = "../ente-X". El agrupamiento siguiente es lógico: cada crate se
encuentra como crates/core/<nombre>.
1. Init / PID 1
| crate | tipo | resumen |
|---|---|---|
ente-zero |
binario | PID 1 del fractal. Bucle primordial (reap + bus + handshake). |
ente-kernel |
lib | bootstrap_kernel_surface(), subreaper, SIGCHLD/uevent streams. |
ente-soma |
lib (shim) | Re-export sobre crates/shared/ente-incarnate (clone+ns+cgroup). |
ente-snapshot |
lib | FractalSnapshot JSON — checkpoint/restore del grafo de Cards. |
2. Contratos canónicos
| crate | resumen |
|---|---|
brahman-card |
Card { soma, payload, flow, permissions, supervision, genesis }. |
brahman-card-wit |
Extracción de interfaces WIT de componentes WASM. |
brahman-cards |
Helpers para construir Cards típicas (consumer/producer/broker). |
ente-card |
Alias histórico — re-export de brahman-card con nombres legacy. |
3. Discovery / Routing
| crate | resumen |
|---|---|
brahman-handshake |
Protocolo Init↔módulo (Hello, Ping, ListSessions) postcard/Unix. |
brahman-broker |
Service locator: empareja flow.input ↔ flow.output por tipo. |
brahman-admin |
Socket separado para snapshots de sesiones + matches. |
4. IPC interno + Storage
| crate | resumen |
|---|---|
ente-bus |
Unix SOCK_STREAM con framing postcard. Announce/Invoke/ListEntes. |
ente-cas |
Content-addressed storage SHA-256 (blobs Wasm, audit log). |
ente-wasm |
Encarna Payload::Wasm vía wasmi en thread dedicado. |
5. Cerebro / Observabilidad
| crate | resumen |
|---|---|
ente-brain |
Rule engine + observer estadístico + audit log con hash chain a CAS. |
ente-echo |
Ente de prueba — provee Capability::Endpoint(echo) para smoke tests. |
6. Compat systemd (shims D-Bus)
Cada shim es un binario que se anuncia con un nombre well-known
org.freedesktop.X1 y traduce las llamadas al bus interno. Esto permite
que GNOME/KDE/aplicaciones legacy arranquen sobre arje sin systemd:
| binario | reemplaza | nombre D-Bus |
|---|---|---|
ente-logind-compat |
systemd-logind |
org.freedesktop.login1 |
ente-hostnamed-compat |
systemd-hostnamed |
org.freedesktop.hostname1 |
ente-timedated-compat |
systemd-timedated |
org.freedesktop.timedate1 |
ente-localed-compat |
systemd-localed |
org.freedesktop.locale1 |
ente-journald-compat |
systemd-journald |
org.freedesktop.LogControl1 |
ente-resolved-compat |
systemd-resolved |
org.freedesktop.resolve1 |
ente-polkit-compat |
polkitd |
org.freedesktop.PolicyKit1 |
ente-machined-compat |
systemd-machined |
org.freedesktop.machine1 |
ente-systemd1-compat |
systemd (Manager) |
org.freedesktop.systemd1 |
ente-notify-compat |
sd_notify socket |
/run/systemd/notify (datagram) |
ente-timer-compat |
systemd-timer |
(cron-like, sin D-Bus) |
ente-tmpfiles-compat |
systemd-tmpfiles |
(aplica tmpfiles.d al boot) |
ente-binfmt-compat |
systemd-binfmt |
(registra binfmt_misc handlers) |
ente-policy-provider |
(interno) | proveedor de decisiones polkit |
Crates relacionados fuera de core/
Dependen del Init pero viven en crates/shared/:
ente-incarnate— rutina pura declone(2) + namespaces + cgroup + rlimits + cpu_affinity. Reusable por shipote y supervisores no-PID-1.brahman-net— malla P2P opcional (libp2p) que extiende el handshake.brahman-sidecar— helperspawn(card)para que las apps se presenten al Init sin reimplementar el cliente del handshake.
Convención de uso
Para arrancar el Init y ejecutar Cards, ver:
- Seeds estándar en
seeds/. - Build de initramfs con
scripts/build-arje-initrd.sh. - Boot en QEMU / bare metal documentado en
docs/arje-boot.md.