sergio
550c98f275
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>
35 lines
1.5 KiB
Markdown
35 lines
1.5 KiB
Markdown
# runtime/ — Infraestructura de ejecución
|
|
|
|
**Propósito.** Servicios cross-cutting que el Init y los módulos
|
|
consumen: bus IPC interno, content-addressed storage, sandbox WASM,
|
|
rule engine + audit log, y un ente de smoke test.
|
|
|
|
## Crates
|
|
|
|
| crate | tipo | rol |
|
|
| ------------- | ---- | ----------------------------------------------------------- |
|
|
| `ente-bus` | lib | Unix SOCK_STREAM + postcard framing. Announce/Invoke/List |
|
|
| `ente-cas` | lib | Content-addressed storage SHA-256: blobs Wasm + audit log |
|
|
| `ente-wasm` | lib | Encarna `Payload::Wasm` vía `wasmi` en thread dedicado |
|
|
| `ente-brain` | lib | Rule engine + observer estadístico + audit chain con CAS |
|
|
| `ente-echo` | bin | Ente prueba — provee `Capability::Endpoint(echo)` |
|
|
|
|
## Dependencias
|
|
|
|
- `ente-bus` ← `tokio` + `postcard`. Consumido por `init/ente-zero`.
|
|
- `ente-cas` ← `sha2` + `sled`. Consumido por `ente-brain` (audit log)
|
|
y `ente-wasm` (blobs).
|
|
- `ente-brain` ← `ente-bus`, `ente-cas`. Consumido por Init para
|
|
observabilidad estadística + reglas declarativas.
|
|
|
|
## Invariantes
|
|
|
|
- Bus: framing length-prefixed, sin re-orden; un cliente=una sesión.
|
|
- CAS: addresses inmutables; un blob = sha256(content) único.
|
|
- Audit: cada evento del bus se hash-encadena al log en CAS.
|
|
|
|
## Estado
|
|
|
|
LOC ~3.4K, tests parciales. Brain tiene 11 TODOs (reglas declarativas
|
|
complejas pendientes). Ver `docs/changelog/runtime.md`.
|