sergio
e570c6ca6f
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>
64 lines
3.0 KiB
Markdown
64 lines
3.0 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 | Struct `Card` (19 campos, ver abajo) |
|
|
| `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` |
|
|
|
|
## Struct `Card` (anatomía completa)
|
|
|
|
```rust
|
|
pub struct Card {
|
|
schema_version: u16, // versión del esquema fractal
|
|
id: Ulid, // identidad opaca única
|
|
lineage: Option<Ulid>, // ancestro genealógico
|
|
label: String, // nombre humano-legible
|
|
provides: BTreeSet<Capability>,
|
|
requires: BTreeSet<Capability>,
|
|
permissions: Permissions, // sandbox declarativo
|
|
soma: SomaSpec, // runtime Linux (ns + cgroup + rlimits)
|
|
payload: Payload, // WASM | ELF | Virtual | Legacy
|
|
supervision: Supervision, // restart policy
|
|
lifecycle: Lifecycle, // ortogonal a supervision
|
|
priority: Priority,
|
|
flow: Flows, // contratos de datos in/out
|
|
service_socket: Option<PathBuf>, // data plane separado
|
|
references: Vec<CardReference>, // grafo de relaciones
|
|
kind: CardKind, // Ente | Monada | Index | ...
|
|
data: Option<DataFacet>, // None para entes runtime
|
|
genesis: Vec<Card>, // hijas a encarnar inmediatamente
|
|
priority_contexts: BTreeMap<String, ContextBias>,
|
|
}
|
|
```
|
|
|
|
## 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`.
|