Files

T

sergio e570c6ca6f docs: fix factual errors en SDDs y STATUS/ROADMAP

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>

2026-05-19 17:03:05 +00:00

3.0 KiB

Raw Blame History

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)

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.

3.0 KiB Raw Blame History