Files
brahman/docs/ROADMAP.md
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

98 lines
4.7 KiB
Markdown

# ROADMAP — Plan a finalización
Ordenado por dependencias (lo más bajo en el stack primero) y por
impacto (lo que desbloquea más trabajo).
## Hito 0 · Cierre del reorg (HOY, 2026-05-19) ✅
- [x] Split core/ → protocol + init + runtime + compat
- [x] Renames: shipote→shuma, nouser→akasha, yahweh→nahual, lapaloma→pineal
- [x] Fraccionamiento: vista-core, barra-core extraídos
- [x] SDDs por subdirectorio
- [x] CHANGELOG particionado por proyecto
- [x] `cargo check --workspace` pasa
## Hito 1 · Cobertura de tests donde falta (1-2 semanas)
| Tarea | Bloquea |
| ----------------------------------------------------- | ---------------------- |
| Tests sobre `cosmobiologia-canvas` (2,850 LOC GPUI) | Confianza UI cosmo |
| Tests sobre `cosmobiologia-tree` (2,295 LOC GPUI) | Confianza UI cosmo |
| Tests sobre `akasha-core::cluster` (k-means) | Embeddings drift |
| Tests `FractalSnapshot` restore con stale fds (init/) | Resiliencia init |
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) | 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 filesystem
montable (editor abriendo paths semánticos).
## Hito 3 · Cerrar TODOs concentrados (2 semanas)
| Crate | TODOs | Trabajo |
| ---------------------- | ----- | ----------------------------------------- |
| `ente-brain` | 11 | Rule engine declarativo + observer |
| `shuma-core` | 14 | Supervisión avanzada (restart + health) |
| `brahman-handshake` | 10 | Trust fase 4 (revocaciones, beyond peer) |
| `cosmobiologia-engine` | 12 | Sistema GR + harmonics (tareas #55-#63) |
## Hito 4 · Cosmobiología — innovaciones (3-4 semanas)
Memorias del proyecto detallan:
- **Sistema GR (8 tareas #55-#62)**: dual-ring directas+conversas, scrubbing
live, HUD triggers, modo rectificación.
- **FFT armónico (#63)**: detección automática de ciclos en órbitas.
- **Research bank (#64-#65)**: corpus de cartas + queries.
- **3D celestial sphere (#66)**: renderer esférico no 2D.
- **Rectificador automático (#67)**: ajuste hora natal vía eventos.
## Hito 5 · Polish + DX (1 semana)
- Renombrar binario `shipote``shuma` (queda como alias por compat).
- Renombrar binario `yahweh``nahual` (queda como alias).
- Doc onboarding: README raíz que apunte a los SDDs.
- Script `scripts/check.sh` que corra `fmt + clippy + test --workspace`.
- Actualizar `seeds/arje-*.card.json` con nombres nuevos.
## Hito 6 · Compat avanzado systemd (3 semanas, paralelo a hitos 3-5)
| Shim | Métodos pendientes |
| --------------------- | ------------------------------------ |
| `ente-logind-compat` | `Inhibit`, `Sleep` hooks |
| `ente-localed-compat` | `SetVariable` |
| `ente-machined-compat`| `MachineImage` operations |
Permite correr GNOME/KDE end-to-end sin parches.
## Cronograma indicativo
```
Semana 1 Semana 2 Semana 3 Semana 4-5 Semana 6+
[Hito 1] [Hito 2] [Hito 3 ───→] [Hito 4 ──→] [Hito 5]
[Hito 6 ─────────────→]
```
**Tiempo estimado a finalización**: ~6-8 semanas si una persona en
solitario; ~3-4 si se paraleliza (hito 1 con hito 6 son disjuntos).
## Métricas de éxito
- 100% crates con `cargo test` verde.
- 0 stubs `<50 LOC` que no sean intencionales.
- `minga-vfs` montable como `mount.minga`.
- Cosmobiología cubriendo: cartas natales, dial GR, harmonics, 3D, rectificación.
- GNOME Shell arrancable sobre `arje` (Init = `ente-zero`) sin parches.