# modules/shuma/ — Runtime de espacios aislados (era shipote)

**Propósito.** Cada Workspace = un proceso aislado (namespaces +
cgroups + capabilities filtradas) que expone un wire protocol tipado.
El daemon es dueño de los workspaces; los clientes (cli/shell/gateway)
hablan postcard sobre Unix socket.

## Crates

| crate             | tipo | rol                                                     |
| ----------------- | ---- | ------------------------------------------------------- |
| `shuma-card`      | lib  | Card del daemon + spec del Workspace                    |
| `shuma-protocol`  | lib  | Wire types: requests/responses + framing                |
| `shuma-discern`   | lib  | Lookup de daemon vía broker brahman                     |
| `shuma-core`      | lib  | Pipeline: parse spec → encarnar → supervisar → persist  |
| `shuma-intent`    | lib  | Intenciones, grafo de sesión y libro de macros          |
| `shuma-line`      | lib  | Análisis de la línea de comandos: lexer bash, clasificación, pipeline, autocompletado, `LineState` editable — agnóstico (GUI/TUI) |
| `shuma-sysmon`    | lib  | Muestreo de CPU/memoria con historial para los monitores |
| `shuma-shell-render` | lib | Layout del lienzo de intenciones                       |

App: `apps/shuma-shell` — el shell GPUI: input inteligente (resaltado +
autocompletado + pipes vía `shuma-line`), monitores con curva
(`shuma-sysmon`) y lienzo de intenciones. Crates agnósticos → un futuro
`shuma-shell-tui` reusaría `shuma-line` + `shuma-sysmon` sin cambios.

## Dependencias

- `shuma-core` ← `init/ente-incarnate` (encarnación real).
- `shuma-protocol` ← `protocol/brahman-card`.
- Apps: `shuma-daemon` (dueño), `shuma-cli`, `shuma-shell` (GUI),
  `shuma-gateway` (HTTP/JSON ↔ postcard).

## Docs

Documentación completa en `crates/modules/shuma/docs/`:
- `ARCHITECTURE.md` — diseño + flow
- `CLI.md` — referencia del cli
- `DEVELOPMENT.md` — guía de contribución
- `RECIPES.md` — specs ejemplo de Workspace

## Estado

LOC 6,907. Backend completo (daemon + cli funcionales). Tests sobre
discern + protocol. 14 TODOs en core (supervisión avanzada). Ver
`docs/changelog/shuma.md`.