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>
This commit is contained in:
sergio
2026-05-19 17:03:05 +00:00
parent 550c98f275
commit e570c6ca6f
9 changed files with 74 additions and 30 deletions
+27 -1
View File
@@ -8,7 +8,7 @@ flows por tipo, y wire types de red. No corre lógica de dominio.
| crate | tipo | rol |
| ---------------------- | ---- | -------------------------------------------------------- |
| `brahman-card` | lib | `Card { soma, payload, flow, permissions, supervision }` |
| `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 |
@@ -18,6 +18,32 @@ flows por tipo, y wire types de red. No corre lógica de dominio.
| `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.