1# apps/ — Binarios finales
2
3**Propósito.** Aplicaciones ejecutables que consumen el protocolo
4brahman y los módulos. Cada app es un `[[bin]]` o `cdylib` standalone.
5
6## Mapa
7
8### Protocol / Init
9- `brahman-broker-explorer` — probe GPUI del broker (matches + sessions)
10- `brahman-demo` — bootstrap reproducible: broker + producer + consumer
11
12### Nahual (GPUI suite)
13- `nahual-shell` — shell standard de explorers (sidebar+main+status)
14- `nahual-file-explorer`, `nahual-database-explorer`,
15  `nahual-text-viewer`, `nahual-image-viewer`
16
17### Akasha
18- `akasha-explorer` — descubre el daemon `akasha-core` y lista Mónadas
19
20### Nakui (ERP)
21- `nakui-ui` — MetaUi+MetaForm con event log + replay
22- `nakui-explorer` — dashboard sobre stack nahual
23
24### Minga
25- `minga-explorer` — dashboard de DHT semántico + indexer status
26
27### Shuma (sandboxes)
28- `shuma-daemon` — dueño de Workspaces (postcard sobre Unix socket)
29- `shuma-cli` — CLI admin (`shipote` binario por compat)
30- `shuma-gateway` — HTTP/JSON ↔ postcard
31- `shuma-shell` — GUI GPUI de Workspaces
32
33### Pineal (demos data-viz)
34- `pineal-demo`, `pineal-stream-demo`, `pineal-phosphor-demo`,
35  `pineal-financial-demo`
36
37### Web targets (cdylib WASM)
38- `gioser-web` — landing chacana
39- `cosmobiologia-web` (en modules/, no apps/) — bridge SVG
40
41### Cosmobiología
42- `cosmobiologia` — app GPUI principal (tree + canvas + panel)
43- `cosmobiologia-cli` — calcula cartas headless
44- `cosmobiologia-server` — server HTTP single-user con CRUD
45
46## Convenciones
47
48- Cada app declara su `Card` y se anuncia al Init vía `brahman-sidecar`.
49- Apps que viven dentro de GPUI consumen `nahual-shell` para el chrome.
50- Apps headless usan `clap` para argv.
51- Tests E2E: usar `gpui::TestAppContext` para GPUI; CLI tests via
52  `tempfile` + `assert_cmd`.