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

4.7 KiB

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)

  • Split core/ → protocol + init + runtime + compat
  • Renames: shipote→shuma, nouser→akasha, yahweh→nahual, lapaloma→pineal
  • Fraccionamiento: vista-core, barra-core extraídos
  • SDDs por subdirectorio
  • CHANGELOG particionado por proyecto
  • 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 shipoteshuma (queda como alias por compat).
  • Renombrar binario yahwehnahual (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.