sergio
b83d40a833
Rename batch de la Fase A del PLAN_MACRO: - 25 crates ente-* → arje-* (protocol/init/runtime/compat). El linaje arje (init Linux) queda con prefijo coherente. - vista → revista (revista-core + revista-web). - pluma → fana (fana-md + fana-md-reader-web). fana absorbe el linaje markdown de pluma; será el writer DAG editor (prioridad alta). Cambios: - git mv de 29 crate dirs + 2 SDDs - package/lib/bin names + path refs + imports .rs reescritos - workspace Cargo.toml + comentarios de sección - SDDs de init/runtime/compat/protocol actualizados a arje- - SDD de revista + SDD de fana (reescrito: writer DAG editor) - docs/STATUS.md, ROADMAP.md, PLAN_MACRO.md, arje-boot.md, arje-replace-systemd.md actualizados - docs/changelog/akasha.md → chasqui.md scripts/rename-fase-a.py idempotente (--dry-run soportado). cargo check --workspace verde. 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) |
|
|
| `arje-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`.
|