From 2540e74046fb65bb00b7f7a60ec1e39171ababee Mon Sep 17 00:00:00 2001 From: sergio Date: Wed, 20 May 2026 18:40:31 +0000 Subject: [PATCH] =?UTF-8?q?docs(shuma):=20SDD=20=E2=80=94=20shuma-session,?= =?UTF-8?q?=20shuma-exec=20y=20la=20distinci=C3=B3n=20con=20sandokan?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.7 --- crates/modules/shuma/SDD.md | 21 ++++++++++++++++----- 1 file changed, 16 insertions(+), 5 deletions(-) diff --git a/crates/modules/shuma/SDD.md b/crates/modules/shuma/SDD.md index 9ccdcc8..9d81280 100644 --- a/crates/modules/shuma/SDD.md +++ b/crates/modules/shuma/SDD.md @@ -15,13 +15,24 @@ hablan postcard sobre Unix socket. | `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-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-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 + -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. +App: `apps/shuma-shell` — el shell GPUI: input inteligente (`shuma-line`), +ejecución real con streams (`shuma-exec`) volcada al panel central, +sesión de trabajo con cwd/aislamiento (`shuma-session`), monitores con +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