tawasuyu/brahman
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(shuma): SDD — shuma-session, shuma-exec y la distinción con sandokan

Browse Source 
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
sergio
2026-05-20 18:40:31 +00:00
parent 90607bd7c0
commit 2540e74046
1 changed files with 16 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
crates/modules/shuma/SDD.md
+16 -5
View File
@@ -15,13 +15,24 @@ hablan postcard sobre Unix socket.
| `shuma-core` | lib | Pipeline: parse spec → encarnar → supervisar → persist | | `shuma-core` | lib | Pipeline: parse spec → encarnar → supervisar → persist |
| `shuma-intent` | lib | Intenciones, grafo de sesión y libro de macros | | `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-line` | lib | Análisis de la línea de comandos: lexer bash, clasificación, pipeline, autocompletado, `LineState` editable — agnóstico (GUI/TUI) |
| `shuma-session` | lib | `WorkSession`: cwd (= identificador de aislamiento), historial de comandos y grupos reutilizables |
| `shuma-exec` | lib | Ejecución de comandos con salida en streaming (stdout/stderr línea a línea por canal) |
| `shuma-sysmon` | lib | Muestreo de CPU/memoria con historial para los monitores | | `shuma-sysmon` | lib | Muestreo de CPU/memoria con historial para los monitores |
| `shuma-shell-render` | lib | Layout del lienzo de intenciones | | `shuma-shell-render` | lib | Layout del lienzo de intenciones (legado del grafo) |
App: `apps/shuma-shell` — el shell GPUI: input inteligente (resaltado + App: `apps/shuma-shell` — el shell GPUI: input inteligente (`shuma-line`),
autocompletado + pipes vía `shuma-line`), monitores con curva ejecución real con streams (`shuma-exec`) volcada al panel central,
(`shuma-sysmon`) y lienzo de intenciones. Crates agnósticos → un futuro sesión de trabajo con cwd/aislamiento (`shuma-session`), monitores con
`shuma-shell-tui` reusaría `shuma-line` + `shuma-sysmon` sin cambios. curva (`shuma-sysmon`) y divisores arrastrables. Los crates son
agnósticos → un futuro `shuma-shell-tui` los reusaría sin cambios.
## sandokan vs. shuma-exec
`sandokan` orquesta *Cards* de brahman (entidades aisladas y
supervisadas) y es **poll-based por diseño**. El shell ejecuta líneas de
shell ad-hoc y necesita ver la salida fluir → eso es `shuma-exec`. Dos
capas distintas, a propósito; un comando que lance un módulo brahman
podría enrutarse por sandokan más adelante.
## Dependencias ## Dependencias