Files
brahman/docs/ROADMAP.md
T
sergio 550c98f275 refactor(monorepo): reorganización lógica + renames + SDDs + split CHANGELOG
Reorganización física de crates/:
- core/ (mezclaba 6 propósitos) se divide en protocol/, init/, runtime/, compat/
- shared/ (3 crates) se redistribuye en protocol/ e init/
- lapaloma (sub-módulo de ui_engine) se promueve a modules/pineal/

Renames de proyectos:
- shipote → shuma (runtime de sandboxes)
- nouser → akasha (explorador de Mónadas)
- yahweh → nahual (motor GPUI, antes ui_engine/)
- lapaloma → pineal (data-viz agnóstica)

Fraccionamiento UI → core agnóstico:
- vista-core (DeckState + snap, 175 LOC, 5 tests verdes)
- barra-core (Task + render_html + sanitize, 90 LOC, 5 tests verdes)
- vista-web y barra-web ahora son thin DOM bindings

Documentación nueva:
- 16 SDDs por subdirectorio (≤80 LOC c/u): protocol/init/runtime/compat
  + 10 módulos + apps/
- docs/STATUS.md con cifras reales por proyecto
- docs/ROADMAP.md con plan a finalización (6 hitos, ~6-8 semanas)
- CHANGELOG.md particionado en docs/changelog/<proyecto>.md (7 buckets)

Automatización:
- scripts/reorg.py — script idempotente que: git mv directorios, renombra
  package names, recomputa path = refs, reescribe imports rust, actualiza
  workspace Cargo.toml. Soporta --dry-run.
- scripts/split-changelog.py — particiona CHANGELOG por componente.

Validación:
- cargo check --workspace pasa (124 crates + 2 nuevos cores).
- 10 tests adicionales (5 en vista-core + 5 en barra-core) verdes.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-19 14:48:34 +00:00

4.3 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) 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

Salida: 6 charts más operativos + minga viable como sistema de archivos.

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.