# 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: revista-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                                   |
| ---------------------- | ----- | ----------------------------------------- |
| `arje-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                   |
| --------------------- | ------------------------------------ |
| `arje-logind-compat`  | `Inhibit`, `Sleep` hooks             |
| `arje-localed-compat` | `SetVariable`                        |
| `arje-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 = `arje-zero`) sin parches.
