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>
38 lines
1.9 KiB
Markdown
38 lines
1.9 KiB
Markdown
# protocol/ — Contratos canónicos + routing
|
|
|
|
**Propósito.** Núcleo de intercomunicación del fractal: tipos canónicos
|
|
(`Card`, capabilities, soma), handshake módulo↔Init, broker que empareja
|
|
flows por tipo, y wire types de red. No corre lógica de dominio.
|
|
|
|
## Crates
|
|
|
|
| crate | tipo | rol |
|
|
| ---------------------- | ---- | -------------------------------------------------------- |
|
|
| `brahman-card` | lib | `Card { soma, payload, flow, permissions, supervision }` |
|
|
| `brahman-card-wit` | lib | Extracción WIT desde componentes WASM |
|
|
| `brahman-cards` | lib | Templates Nickel + helpers consumer/producer/broker |
|
|
| `brahman-handshake` | lib | Init↔módulo: Hello, Ping, ListSessions, ListMatches |
|
|
| `brahman-broker` | lib | Service locator: flow.input ↔ flow.output por tipo |
|
|
| `brahman-admin` | lib | Socket admin separado: snapshots de sesiones+matches |
|
|
| `brahman-sidecar` | lib | `spawn(card)` para que apps se presenten al Init |
|
|
| `brahman-net` | lib | Malla libp2p opcional (TCP+noise+yamux+kad) |
|
|
| `ente-card` | lib | Alias legacy — re-export de `brahman-card` |
|
|
|
|
## Dependencias
|
|
|
|
- Intra: handshake → card + broker; sidecar → card; net → handshake.
|
|
- Cross: consumido por todos los `modules/*` y `apps/*`.
|
|
- No depende de `init/` ni de `runtime/` (es la base).
|
|
|
|
## Invariantes
|
|
|
|
- Serialización: `postcard` length-prefixed sobre Unix SOCK_STREAM, JSON
|
|
sobre HTTP (gateway). Schemas reproducibles vía Nickel.
|
|
- Identidad: `peer_id` libp2p + firma Ed25519 anclada al peer.
|
|
- Sesiones: el handshake mantiene una sesión por módulo encarnado.
|
|
|
|
## Estado
|
|
|
|
Base estable (6,260 LOC con tests). 19 TODOs concentrados en handshake
|
|
(trust remoto fase 3) y broker. Ver `docs/changelog/protocol.md`.
|