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
+1 -1
View File
@@ -11,7 +11,7 @@ cgroups, y snapshot/restore del grafo.
| ---------------- | ------- | ----------------------------------------------------- |
| `ente-zero` | binario | PID 1: reap + handshake server + bus dispatcher |
| `ente-kernel` | lib | `bootstrap_kernel_surface`, subreaper, SIGCHLD/uevent |
| `ente-soma` | lib | Shim sobre `ente-incarnate` (compatibilidad legacy) |
| `ente-soma` | lib | Wrapper 44 LOC sobre `ente-incarnate` (compat API) |
| `ente-incarnate` | lib | `clone(2) + namespaces + cgroup + rlimits + cpu` |
| `ente-snapshot` | lib | `FractalSnapshot` JSON: checkpoint del grafo Cards |
+4 -2
View File
@@ -18,8 +18,10 @@ locales (mock o real LLM) y un protocolo `Nous` line-delimited.
- `akasha-core``protocol/brahman-card`, `protocol/brahman-sidecar`,
`akasha-card`, `akasha-nous`, `shuma-discern`.
- `akasha-nous-real``fastembed` + `ort` (heavy; profile opt-level=1
en root Cargo.toml).
- `akasha-nous-real``fastembed` (opcional, detrás de feature
`embeddings`; `ort` viene transitivo). Sin feature, el crate compila
como stub mínimo. Profile opt-level=1 en root Cargo.toml para
`fastembed`/`ort`/`tokenizers`/`image`.
- Consumido por: `apps/akasha-explorer` (GPUI dashboard).
## Estado
+1 -1
View File
@@ -38,4 +38,4 @@ bar.on_click(|id, cx, cy| { /* center en CSS pixels */ });
## Estado
barra-core: 5 tests verdes (sanitize + escape + render). barra-web:
binding mínimo (mount + click + center lookup). LOC ~280.
binding mínimo (mount + click + center lookup). LOC core 108 + web ~190.
+12 -3
View File
@@ -30,6 +30,15 @@ de visualización no conocen `gpui` ni `wgpu`: hablan contra el trait
## Estado
LOC ~3,900. 5 charts implementados (cartesian/financial/stream/phosphor
/export). 5 stubs (<50 LOC c/u: polar, heatmap, treemap, flow, mesh).
Roadmap: completar los 5 stubs en orden polar → heatmap → treemap.
LOC ~4,000. **5 charts implementados** (LOC reales):
- `core` 878, `render` 386, `cartesian` 1397, `financial` 688,
`stream` 231, `phosphor` 312, `umbrella` 53.
**6 stubs (<30 LOC c/u)** — completar:
- `polar` 16, `heatmap` 21, `treemap` 12, `flow` 16, `mesh` 28,
`export` 23 (SVG exporter no implementado pese a depender de él
el roadmap; verificar si export depende de los charts o vice versa).
Roadmap: cerrar los 6 stubs. Orden sugerido: polar → heatmap →
treemap → flow → mesh → export (este último porque depende del
renderer común).
+5 -3
View File
@@ -11,7 +11,7 @@ y los publica en un DHT. Búsqueda por similitud semántica cross-repo.
| `minga-core` | lib | Parser + α-hashing (Rust/Py/TS/JS/Go) + scoring |
| `minga-store` | lib | Sled backend para índice local |
| `minga-p2p` | lib | Capa libp2p: kad + bootstrap + provider records |
| `minga-vfs` | lib | Stub (2 LOC) — montaje VFS de mónadas remotas |
| `minga-vfs` | lib | Stub (2 LOC) — FUSE que proyecta el índice como filesystem |
| `minga-cli` | bin | CLI: index, search, peers, bootstrap |
## Dependencias
@@ -30,5 +30,7 @@ cierres en Py/TS/JS/Go.
## Estado
LOC 5,091. Indexa repos reales. 15 TODOs en core (más patterns para
cada lenguaje). `minga-vfs` aún no implementado — gating del
"file system de mónadas". Ver `docs/changelog/minga.md`.
cada lenguaje). `minga-vfs` aún no implementado — bloquea el montaje
del repo como filesystem (paths virtuales → blobs por hash bajo
demanda). NO está relacionado con Mónadas (esas son de `akasha/`).
Ver `docs/changelog/minga.md`.
+1 -1
View File
@@ -37,4 +37,4 @@ if let Some(r) = deck.pointer_end(offset, width, n_pages) {
vista-core: 5 tests verdes (drag decision + snap + clamp + goto).
vista-web: binding DOM intacto, ahora delega toda la lógica a core.
LOC 530 (core 175 + web 355). Reutilizable en backends no-web.
LOC core 177 + web ~355. Reutilizable en backends no-web.
+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.