tawasuyu/brahman
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: fix factual errors en SDDs y STATUS/ROADMAP

Browse Source 
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
Download Patch File Download Diff File Expand all files Collapse all files
docs/ROADMAP.md
+13 -9
View File
@@ -25,16 +25,20 @@ Salida: cada crate con ≥1 test E2E + matriz de pánico.
## Hito 2 · Cerrar stubs bloqueantes (1 semana)
| Stub | Donde |
| ----------------------------------- | -------------------------------------- |
| `minga-vfs` (actual: 2 LOC) | Mount FUSE de mónadas remotas |
| `pineal-polar` (<50 LOC) | Gráfico circular polar |
| `pineal-heatmap` (<50 LOC) | Grid 2D color-mapped |
| `pineal-treemap` (<50 LOC) | Rectangular treemap |
| `pineal-flow` (<50 LOC) | Sankey / flow diagrams |
| `pineal-mesh` (<50 LOC) | Triangle mesh + barycentric |
| Stub | Donde |
| ----------------------------- | ------------------------------------------------------ |
| `minga-vfs` (actual: 2 LOC) | FUSE: proyecta el índice de minga como filesystem. |
| | Resuelve paths virtuales → blobs por hash bajo demanda |
| | contra `minga-core` + DHT. NO relacionado con Mónadas. |
| `pineal-polar` (16 LOC) | Gráfico circular polar |
| `pineal-heatmap` (21 LOC) | Grid 2D color-mapped |
| `pineal-treemap` (12 LOC) | Rectangular treemap |
| `pineal-flow` (16 LOC) | Sankey / flow diagrams |
| `pineal-mesh` (28 LOC) | Triangle mesh + barycentric |
| `pineal-export` (23 LOC) | SVG/PNG export del RenderPlan |
Salida: 6 charts más operativos + minga viable como sistema de archivos.
Salida: 6 charts más operativos + minga viable como filesystem
montable (editor abriendo paths semánticos).
## Hito 3 · Cerrar TODOs concentrados (2 semanas)
docs/STATUS.md
+10 -9
View File
@@ -15,7 +15,7 @@ y `grep` sobre `src/` en cada crate (sin contar `target/` ni docs).
### `protocol/` — Estable
| LOC | Tests | TODOs | Madurez |
|---|---|---|---|
| 6,260 | sí | 19 | ★★★★☆ |
| 7,278 | sí | 19 | ★★★★☆ |
Base del fractal. Handshake fase 3 (trust Ed25519) completo. Pendiente:
fase 4 (trust beyond peer, capabilities revocables).
@@ -23,7 +23,7 @@ fase 4 (trust beyond peer, capabilities revocables).
### `init/` — Funcional
| LOC | Tests | TODOs | Madurez |
|---|---|---|---|
| ~3,600 | parcial | ~5 | ★★★★☆ |
| 4,301 | parcial | ~5 | ★★★★☆ |
Bootea bare metal + QEMU + initramfs. Pendiente: cobertura tests sobre
`FractalSnapshot` restore con stale fds y validación de re-encarnación.
@@ -31,7 +31,7 @@ Bootea bare metal + QEMU + initramfs. Pendiente: cobertura tests sobre
### `runtime/` — Funcional con deuda
| LOC | Tests | TODOs | Madurez |
|---|---|---|---|
| ~3,400 | parcial | ~14 | ★★★☆☆ |
| 3,418 | parcial | ~14 | ★★★☆☆ |
`ente-brain` concentra 11 TODOs (rule engine declarativo + observer
estadístico). `ente-bus`/`ente-cas`/`ente-wasm` estables.
@@ -39,7 +39,7 @@ estadístico). `ente-bus`/`ente-cas`/`ente-wasm` estables.
### `compat/` — Cobertura mínima viable
| LOC | Tests | TODOs | Madurez |
|---|---|---|---|
| ~5,000 | no (esperado) | bajo | ★★★☆☆ |
| 3,435 | no (esperado) | bajo | ★★★☆☆ |
14 shims D-Bus operativos. Suficiente para GNOME/KDE/PolicyKit básicos.
Pendiente: métodos avanzados (Inhibit en logind, SetVariable en localed).
@@ -63,10 +63,11 @@ shell standard. Estable.
### `modules/pineal/` — Funcional con stubs
| LOC | Tests | TODOs | Madurez |
|---|---|---|---|
| ~3,900 | sí | bajo | ★★★☆☆ |
| ~4,000 | sí | bajo | ★★★☆☆ |
5 charts funcionales (cartesian, financial, stream, phosphor, export).
**5 stubs (<50 LOC c/u): polar, heatmap, treemap, flow, mesh.**
5 charts funcionales (`core`, `render`, `cartesian`, `financial`,
`stream`, `phosphor`, `umbrella`).
**6 stubs (<30 LOC c/u): `polar`, `heatmap`, `treemap`, `flow`, `mesh`, `export`.**
### `modules/nakui/` — Maduro
| LOC | Tests | TODOs | Madurez |
@@ -109,14 +110,14 @@ Parser + reader web. Pendiente: AST con inline elements (links, emphasis).
### `modules/vista/` — Refactorizado (2026-05-19)
| LOC | Tests | TODOs | Madurez |
|---|---|---|---|
| 530 (175 core + 355 web) | core: 5/5 verdes | 0 | ★★★★☆ |
| ~530 (177 core + ~350 web) | core: 5/5 verdes | 0 | ★★★★☆ |
`vista-core` agnóstico nuevo + `vista-web` ahora thin DOM binding.
### `modules/barra/` — Refactorizado (2026-05-19)
| LOC | Tests | TODOs | Madurez |
|---|---|---|---|
| 280 (90 core + 190 web) | core: 5/5 verdes | 0 | ★★★★☆ |
| ~300 (108 core + ~190 web) | core: 5/5 verdes | 0 | ★★★★☆ |
`barra-core` agnóstico nuevo (Task + render_html). `barra-web`
delega al core.