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>

crates/modules/shuma/docs/CLI.md

@@ -0,0 +1,134 @@
+# Referencia CLI — `shipote`
+
+El binario `shipote` (compilado por `cargo build -p shipote-cli`) se conecta al daemon vía Unix socket. Por default usa `$XDG_RUNTIME_DIR/shipote.sock`; override con `--socket <path>`.
+
+```sh
+shipote [--socket PATH] <comando> [...]
+```
+
+## Comandos globales
+
+### `shipote ping`
+Health-check rápido. Imprime `pong` si el daemon responde.
+
+### `shipote health`
+Health endpoint estructurado.
+```
+version:           0.1.0
+uptime:            11411 ms
+alive_workspaces:  1
+alive_commands:    1
+alive_pipelines:   0
+active_flows:      0
+dirty:             true
+```
+
+### `shipote caps`
+Capacidades runtime detectadas: kernel version, `user_ns` status, `cgroup_v2`, `cgroup_delegated`, `cap_sys_admin`.
+
+### `shipote discern <path>`
+Discierne ad-hoc un archivo (no requiere workspace). Imprime `ty`, `confidence`, `mime`, `lens`.
+
+## Workspaces
+
+### `shipote workspace create <spec.toml|.json>`
+Crea workspace desde un spec. Imprime el ULID asignado. Si el cgroup está delegated y el spec declara rlimits, se aplica `memory.max`/`pids.max`.
+
+### `shipote workspace list`
+Lista workspaces vivos.
+
+### `shipote workspace stats <id>`
+Resource accounting:
+```
+commands:   1 alive / 1 total
+rss:        2.05 MiB
+rss_peak:   58.89 MiB
+cpu:        0.300 s
+cpu_pct:    98.7 % (24.7% total / 4 cores)
+source:     proc
+uptime:     1002 ms
+```
+
+### `shipote workspace quota <id>`
+Reporta breaches del `soma.rlimits`. Si `quota_enforce.{mem,nproc}=Kill`, el daemon mata automáticamente al detectar.
+
+### `shipote workspace stop <id> [--grace-ms N]`
+Stop graceful. Default `grace_ms=1000`. `0` = SIGKILL inmediato.
+
+## Comandos directos
+
+### `shipote run -w <ws-id> [--restart-on-failure] <exec> -- <argv>...`
+One-shot dentro del workspace. Si `--restart-on-failure`, el reaper relanza con backoff exponencial cuando exit != 0.
+
+**Nota**: usar `--` antes de los argv del comando para que clap no los confunda con flags suyos:
+```sh
+shipote run -w 01... /bin/sh -- -c "echo hola"
+```
+
+### `shipote commands <ws-id>`
+Lista comandos del workspace (vivos + exited) con pid, status, bytes_log.
+
+### `shipote logs <ws-id> <cmd-id> [--stream {stdout|stderr|both}] [--tail N] [--follow]`
+Tail del ring buffer de logs.
+- `--stream` default `stdout`. `both` concatena stderr-tras-stdout.
+- `--tail N`: últimos N bytes (0 = todo).
+- `--follow` (`-f`): poll cada 200ms, imprime suffix nuevo hasta que el comando termine.
+
+## Pipelines
+
+### `shipote pipeline run <spec.toml> [--tap] [--tail] [--var KEY=VAL ...]`
+Lanza pipeline.
+- `--tap`: crea flow channels (data plane) por cada edge.
+- `--tail`: auto-implica `--tap`, suscribe al primer flow socket y vuelca a stdout.
+- `--var KEY=VAL` (repetible): sustituye `${KEY}` en el spec antes de lanzar.
+
+### `shipote pipeline stop <pipeline-id> [--grace-ms N]`
+Stop selectivo del pipeline (no afecta otros comandos del workspace).
+
+### `shipote pipeline save <name> <spec.toml>`
+Persiste el spec bajo `name` (sobrevive restart vía snapshot).
+
+### `shipote pipeline saved-list`
+Lista pipelines guardados.
+
+### `shipote pipeline drop <name>`
+Elimina un saved pipeline.
+
+### `shipote pipeline run-saved <name> [--tap] [--tail] [--var KEY=VAL ...]`
+Ejecuta un pipeline guardado con vars opcionales.
+
+## Flows
+
+### `shipote flow list`
+Lista pipelines vivos con sockets activos (uno por edge con `--tap`).
+
+### `shipote flow throughput`
+Bytes acumulados + rate por socket.
+```
+shipote-flow-<ULID>-0.sock  0.1 KiB total  0.07 KiB/s
+```
+
+### `shipote flow tail <socket-path>`
+Conecta directo al Unix socket y vuelca hasta EOF. Si el splitter tiene replay buffer, lo recibís primero.
+
+### `shipote flow drop <pipeline-id>`
+Cierra el data plane de un pipeline (drop de FlowChannels).
+
+## Variables de entorno
+
+- `SHIPOTE_LOG` — filtro `tracing-subscriber` (`info`, `warn`, `audit=info,warn`, ...).
+- `SHIPOTE_TRUST_ANYONE=1` — daemon acepta peers con cualquier uid (testing).
+- `XDG_RUNTIME_DIR` — dónde se crea el socket admin y los flow sockets.
+- `XDG_STATE_HOME` — dónde se guarda el snapshot. Fallback: `$HOME/.local/state/shipote/state.json`.
+
+## Trucos del shell zsh
+
+`shipote run` toma flags propios antes del `--`. Si el comando que ejecutás tiene un argumento que arranca con `-`, usá `--`:
+
+```sh
+# Mal (clap intenta parsear `-c` como flag de shipote):
+shipote run -w <ws> /bin/sh -c "echo hi"
+
+# Bien:
+shipote run -w <ws> /bin/sh -- -c "echo hi"
+```