elsabro 4.2.0 → 4.2.1

package/commands/elsabro/settings.md

@@ -1,6 +1,11 @@
 ---
 name: settings
-description: Ver y modificar configuración de ELSABRO
+description: Ver y modificar configuración de ELSABRO con wizard interactivo
+allowed-tools:
+  - Read
+  - Write
+  - AskUserQuestion
+  - Bash
 ---
 
 # /elsabro:settings
@@ -21,15 +26,14 @@ description: Ver y modificar configuración de ELSABRO
 
 ## Propósito
 
-Gestionar la configuración de ELSABRO - perfiles, preferencias, integraciones y comportamientos.
+Gestionar la configuración de ELSABRO con un **wizard interactivo** que explica cada opción para que el usuario pueda tomar decisiones informadas.
 
 ## Cuándo Usar
 
 ```
 ✅ Ideal para:
-- Configurar ELSABRO por primera vez
-- Ajustar comportamiento (auto-commit, verbosidad)
-- Habilitar/deshabilitar integraciones
+- Configurar ELSABRO por primera vez (wizard automático)
+- Ajustar comportamiento después de la configuración inicial
 - Ver configuración actual
 - Troubleshooting de comportamiento
 
@@ -38,163 +42,455 @@ Gestionar la configuración de ELSABRO - perfiles, preferencias, integraciones y
 - Configuración de proyecto (usa CLAUDE.md)
 ```
 
-## Uso
+## Proceso
 
-```bash
-# Ver configuración actual
-/elsabro:settings
+### Paso 0: Detectar si es primera vez
 
-# Ver setting específico
-/elsabro:settings --get=profile
+```javascript
+const configExists = Read(".elsabro/config.json");
+
+if (!configExists) {
+  // PRIMERA VEZ → Wizard interactivo completo (Paso 1)
+} else if (args === "--reset") {
+  // RESET → Borrar config.json y ejecutar Wizard (Paso 1)
+} else if (args?.startsWith("--set=")) {
+  // EDICIÓN DIRECTA → Modificar setting específico (Paso 4)
+} else {
+  // YA CONFIGURADO → Mostrar dashboard + ofrecer editar (Paso 3)
+}
+```
 
-# Cambiar setting
-/elsabro:settings --set=auto-commit=true
+### Paso 1: Wizard Interactivo (Primera Vez)
 
-# Reset a defaults
-/elsabro:settings --reset
+**OBLIGATORIO**: Si NO existe `.elsabro/config.json`, SIEMPRE ejecutar el wizard completo.
+NO aplicar defaults silenciosamente. Cada opción se presenta al usuario con explicación clara.
+
+Mostrar bienvenida:
+```
+╔══════════════════════════════════════════════════╗
+║  ELSABRO SETUP WIZARD                            ║
+║  Vamos a configurar ELSABRO paso a paso.         ║
+║  Cada opción te explica qué hace.                ║
+╚══════════════════════════════════════════════════╝
 ```
 
-## Vista de Configuración
+Luego ejecutar las preguntas en secuencia (máximo 4 por AskUserQuestion, repetir si hay más):
+
+#### Ronda 1: Perfil y Experiencia
 
+```javascript
+AskUserQuestion({
+  questions: [
+    {
+      question: "¿Qué perfil de trabajo quieres usar?",
+      header: "Perfil",
+      options: [
+        {
+          label: "Default (Recomendado)",
+          description: "Equilibrio entre velocidad y seguridad. Hace code review, corre tests, y pide confirmación para acciones destructivas. Ideal para la mayoría de proyectos."
+        },
+        {
+          label: "Careful",
+          description: "Máxima seguridad. Revisa TODO antes de ejecutar, pide confirmación en cada paso, nunca hace commit automático. Para proyectos críticos (pagos, auth, producción)."
+        },
+        {
+          label: "Yolo",
+          description: "Máxima velocidad, mínima fricción. Menos confirmaciones, commits más rápidos, menos verificaciones. Para prototipos, pruebas, o cuando tienes prisa."
+        }
+      ],
+      multiSelect: false
+    },
+    {
+      question: "¿Cuánta experiencia tienes programando?",
+      header: "Experiencia",
+      options: [
+        {
+          label: "Principiante",
+          description: "No sé mucho de código. Quiero explicaciones detalladas de todo, lenguaje simple, y que me guíes paso a paso."
+        },
+        {
+          label: "Intermedio (Recomendado)",
+          description: "Sé lo básico pero no soy experto. Explicaciones cuando sea necesario, sin abrumarme con detalles técnicos."
+        },
+        {
+          label: "Experto",
+          description: "Sé programar bien. Dame respuestas directas, sin explicaciones básicas. Prefiero eficiencia sobre pedagogía."
+        }
+      ],
+      multiSelect: false
+    },
+    {
+      question: "¿En qué idioma prefieres las respuestas?",
+      header: "Idioma",
+      options: [
+        {
+          label: "Español (Recomendado)",
+          description: "Todas las respuestas, sugerencias y mensajes en español."
+        },
+        {
+          label: "English",
+          description: "All responses, suggestions and messages in English."
+        }
+      ],
+      multiSelect: false
+    }
+  ]
+})
+```
+
+#### Ronda 2: Flujo de Trabajo
+
+```javascript
+AskUserQuestion({
+  questions: [
+    {
+      question: "¿Quieres que ELSABRO haga commit automáticamente cuando termine una tarea?",
+      header: "Auto-commit",
+      options: [
+        {
+          label: "No (Recomendado)",
+          description: "ELSABRO te pregunta antes de hacer commit. Así puedes revisar los cambios, editar el mensaje, o decidir no commitear todavía."
+        },
+        {
+          label: "Sí",
+          description: "ELSABRO hace commit automático al completar cada tarea. Útil si confías en el proceso y quieres menos interrupciones."
+        }
+      ],
+      multiSelect: false
+    },
+    {
+      question: "¿Qué flujo de desarrollo prefieres por defecto?",
+      header: "Flujo",
+      options: [
+        {
+          label: "Standard (Recomendado)",
+          description: "Plan → Ejecutar → Verificar → Review. Flujo completo con tests y code review. Para features importantes y código de producción."
+        },
+        {
+          label: "Quick",
+          description: "Ejecutar directo sin planificación previa. Para cambios pequeños, fixes obvios, o cuando ya sabes exactamente qué hacer."
+        },
+        {
+          label: "Yolo",
+          description: "Máxima velocidad, mínima ceremonia. Sin tests obligatorios ni review. Solo para prototipos o código desechable."
+        }
+      ],
+      multiSelect: false
+    },
+    {
+      question: "¿Quieres que ELSABRO corra los tests automáticamente después de cada cambio?",
+      header: "Auto-tests",
+      options: [
+        {
+          label: "Sí (Recomendado)",
+          description: "Después de cada cambio de código, ELSABRO corre los tests afectados automáticamente. Te avisa si algo se rompe antes de continuar."
+        },
+        {
+          label: "No",
+          description: "No corre tests automáticamente. Tú decides cuándo correrlos con /elsabro:verify. Más rápido pero con riesgo de romper cosas sin darte cuenta."
+        }
+      ],
+      multiSelect: false
+    },
+    {
+      question: "¿Quieres que ELSABRO use múltiples agentes en paralelo para trabajar más rápido?",
+      header: "Paralelo",
+      options: [
+        {
+          label: "Sí (Recomendado)",
+          description: "ELSABRO lanza 2-4 agentes trabajando simultáneamente (exploración, implementación, testing). Más rápido pero usa más recursos del API."
+        },
+        {
+          label: "No",
+          description: "Un solo agente a la vez, secuencial. Más lento pero más predecible y usa menos recursos. Útil si tienes límites de API."
+        }
+      ],
+      multiSelect: false
+    }
+  ]
+})
+```
+
+#### Ronda 3: Integraciones
+
+```javascript
+AskUserQuestion({
+  questions: [
+    {
+      question: "¿Qué integraciones quieres habilitar?",
+      header: "Integraciones",
+      options: [
+        {
+          label: "Todas (Recomendado)",
+          description: "Context7 (documentación actualizada), 21st.dev (componentes UI), Stitch MCP (diseño UI con IA), Pinecone (búsqueda semántica), Playwright (testing de browser)."
+        },
+        {
+          label: "Solo esenciales",
+          description: "Context7 (documentación) y auto-tests. Sin integraciones de diseño ni búsqueda semántica. Instalación mínima."
+        },
+        {
+          label: "Ninguna",
+          description: "Sin integraciones externas. ELSABRO funciona solo con sus agentes internos. Máximo control pero menos funcionalidad."
+        }
+      ],
+      multiSelect: false
+    },
+    {
+      question: "¿Quieres activar Persistent Mode? (ELSABRO siempre activo)",
+      header: "Persistent",
+      options: [
+        {
+          label: "Sí (Recomendado)",
+          description: "ELSABRO intercepta todos tus mensajes y los rutea al comando correcto automáticamente. No necesitas escribir /elsabro: antes de cada comando. Dices 'arregla el bug' y ELSABRO entiende que es /elsabro:debug."
+        },
+        {
+          label: "No",
+          description: "ELSABRO solo responde cuando escribes /elsabro:comando explícitamente. Más control manual pero más fricción."
+        }
+      ],
+      multiSelect: false
+    },
+    {
+      question: "¿Quieres habilitar Skill Discovery? (encontrar skills automáticamente)",
+      header: "Skills",
+      options: [
+        {
+          label: "Sí (Recomendado)",
+          description: "ELSABRO busca automáticamente skills relevantes para tu proyecto (testing, deploy, auth, etc.) en el registry público y te sugiere instalarlos. Ahorra tiempo descubriendo herramientas."
+        },
+        {
+          label: "No",
+          description: "Solo usa los skills que ya tienes instalados. No busca ni sugiere nuevos. Más predecible pero podrías perderte herramientas útiles."
+        }
+      ],
+      multiSelect: false
+    },
+    {
+      question: "¿Cómo prefieres ver los diagramas de arquitectura?",
+      header: "Diagramas",
+      options: [
+        {
+          label: "Mermaid (Recomendado)",
+          description: "Diagramas en formato Mermaid que se renderizan visualmente en GitHub, VS Code y la mayoría de editores. Bonitos y claros."
+        },
+        {
+          label: "ASCII",
+          description: "Diagramas en texto plano con caracteres ASCII (├─ └─ │). Funcionan en cualquier terminal sin necesitar renderizador."
+        },
+        {
+          label: "Ninguno",
+          description: "Sin diagramas. Solo texto descriptivo. Menos visual pero más rápido de generar."
+        }
+      ],
+      multiSelect: false
+    }
+  ]
+})
+```
+
+### Paso 2: Guardar Configuración
+
+Después de las 3 rondas de preguntas, mapear respuestas a config:
+
+```javascript
+// Mapeo de respuestas a config.json
+const config = {
+  profile: mapProfile(answers.perfil),        // "default" | "careful" | "yolo"
+  language: mapLanguage(answers.idioma),       // "es" | "en"
+  experience: mapExperience(answers.exp),      // "beginner" | "intermediate" | "expert"
+  workflow: {
+    "auto-commit": answers.autoCommit === "Sí",
+    "auto-tests": answers.autoTests === "Sí",
+    "parallel-agents": answers.paralelo === "Sí",
+    "default-flow": mapFlow(answers.flujo),    // "standard" | "quick" | "yolo"
+    "require-tests": true,
+    "agent-teams": answers.paralelo === "Sí",  // Linked to parallel agents
+    "blocking-review": answers.perfil !== "Yolo",
+    "max-review-iterations": 5
+  },
+  integrations: {
+    "context7": answers.integraciones !== "Ninguna",
+    "21st-dev": answers.integraciones === "Todas",
+    "stitch-mcp": answers.integraciones === "Todas",
+    "pinecone": answers.integraciones === "Todas",
+    "playwright": answers.integraciones !== "Ninguna",
+    "git-hooks": true,
+    "skill-discovery": answers.skills === "Sí",
+    "persistent-mode": answers.persistent === "Sí"
+  },
+  output: {
+    "verbosity": mapVerbosity(answers.exp),    // beginner→verbose, expert→quiet
+    "colors": true,
+    "diagrams": mapDiagrams(answers.diagramas), // "mermaid" | "ascii" | "none"
+    "style": "explanatory"
+  }
+};
+
+Write(".elsabro/config.json", JSON.stringify(config, null, 2));
+```
+
+Mostrar confirmación:
 ```
 ╔══════════════════════════════════════════════════╗
-║  ELSABRO SETTINGS                                ║
+║  ELSABRO configurado correctamente               ║
 ╠══════════════════════════════════════════════════╣
 ║                                                  ║
-║  PROFILE                                         ║
-║  ├─ Active: default                             ║
-║  ├─ Language: es                                ║
-║  └─ Experience: intermediate                    ║
-║                                                  ║
-║  WORKFLOW                                        ║
-║  ├─ Auto-commit: false                          ║
-║  ├─ Auto-tests: true                            ║
-║  ├─ Parallel agents: true                       ║
-║  └─ Default flow: standard                      ║
-║                                                  ║
-║  INTEGRATIONS                                    ║
-║  ├─ Context7: enabled                           ║
-║  ├─ 21st.dev: enabled                           ║
-║  └─ Git hooks: disabled                         ║
+║  Tu configuración:                               ║
+║  ├─ Perfil: [elegido]                           ║
+║  ├─ Experiencia: [elegido]                      ║
+║  ├─ Idioma: [elegido]                           ║
+║  ├─ Flujo: [elegido]                            ║
+║  ├─ Auto-commit: [elegido]                      ║
+║  ├─ Auto-tests: [elegido]                       ║
+║  ├─ Agentes paralelos: [elegido]                ║
+║  ├─ Integraciones: [elegido]                    ║
+║  ├─ Persistent mode: [elegido]                  ║
+║  ├─ Skill discovery: [elegido]                  ║
+║  └─ Diagramas: [elegido]                        ║
 ║                                                  ║
-║  OUTPUT                                          ║
-║  ├─ Verbosity: normal                           ║
-║  ├─ Colors: true                                ║
-║  └─ Diagrams: mermaid                           ║
+║  Para cambiar después: /elsabro:settings         ║
+║  Para reset completo: /elsabro:settings --reset  ║
 ║                                                  ║
 ╚══════════════════════════════════════════════════╝
 ```
 
-## Settings Disponibles
+### Paso 3: Dashboard (Ya Configurado)
 
-### Profile Settings
-
-| Setting | Values | Default | Description |
-|---------|--------|---------|-------------|
-| `profile` | default/yolo/careful | default | Preset de comportamiento |
-| `language` | en/es | en | Idioma de output |
-| `experience` | beginner/intermediate/expert | intermediate | Nivel de detalle |
+Si `.elsabro/config.json` ya existe, mostrar dashboard con valores actuales:
 
-### Workflow Settings
+```
+╔══════════════════════════════════════════════════╗
+║  ELSABRO SETTINGS v4.2.0                         ║
+╠══════════════════════════════════════════════════╣
+║                                                  ║
+║  [valores actuales del config.json]              ║
+║                                                  ║
+╚══════════════════════════════════════════════════╝
+```
 
-| Setting | Values | Default | Description |
-|---------|--------|---------|-------------|
-| `auto-commit` | true/false | false | Commit automático |
-| `auto-tests` | true/false | true | Correr tests automáticamente |
-| `parallel-agents` | true/false | true | Usar agentes en paralelo |
-| `default-flow` | standard/quick/yolo | standard | Flujo por defecto |
-| `require-tests` | true/false | true | Requerir tests para features |
+Luego preguntar:
 
-### Integration Settings
+```javascript
+AskUserQuestion({
+  questions: [{
+    question: "¿Qué quieres hacer?",
+    header: "Acción",
+    options: [
+      {
+        label: "Está bien así",
+        description: "Mantener la configuración actual sin cambios."
+      },
+      {
+        label: "Cambiar algo",
+        description: "Te muestro cada categoría para que elijas qué ajustar."
+      },
+      {
+        label: "Reset completo",
+        description: "Borrar toda la configuración y volver a ejecutar el wizard desde cero."
+      }
+    ],
+    multiSelect: false
+  }]
+})
+```
 
-| Setting | Values | Default | Description |
-|---------|--------|---------|-------------|
-| `context7` | true/false | true | Usar Context7 para docs |
-| `21st-dev` | true/false | true | Usar 21st.dev para componentes |
-| `git-hooks` | true/false | false | Integrar con git hooks |
+Si elige "Cambiar algo", preguntar qué categoría:
 
-### Output Settings
+```javascript
+AskUserQuestion({
+  questions: [{
+    question: "¿Qué categoría quieres cambiar?",
+    header: "Categoría",
+    options: [
+      {
+        label: "Perfil y experiencia",
+        description: "Cambiar perfil (default/careful/yolo), nivel de experiencia, o idioma."
+      },
+      {
+        label: "Flujo de trabajo",
+        description: "Cambiar auto-commit, auto-tests, agentes paralelos, o flujo por defecto."
+      },
+      {
+        label: "Integraciones",
+        description: "Habilitar/deshabilitar Context7, 21st.dev, Stitch, Pinecone, persistent mode, skill discovery."
+      },
+      {
+        label: "Output y diagramas",
+        description: "Cambiar verbosidad, formato de diagramas, o estilo de salida."
+      }
+    ],
+    multiSelect: false
+  }]
+})
+```
 
-| Setting | Values | Default | Description |
-|---------|--------|---------|-------------|
-| `verbosity` | quiet/normal/verbose | normal | Nivel de output |
-| `colors` | true/false | true | Output con colores |
-| `diagrams` | mermaid/ascii/none | mermaid | Formato de diagramas |
+Luego mostrar las opciones de esa categoría usando AskUserQuestion con las mismas descripciones detalladas del wizard (Paso 1).
 
-## Modificar Settings
+### Paso 4: Edición Directa (CLI)
 
-### Individual
+Para usuarios avanzados que saben qué quieren cambiar:
 
 ```bash
 /elsabro:settings --set=auto-commit=true
+/elsabro:settings --set="profile=yolo,auto-tests=false"
+/elsabro:settings --get=profile
+/elsabro:settings --reset
 ```
 
-### Múltiples
-
-```bash
-/elsabro:settings --set="auto-commit=true,verbosity=verbose"
+Cuando se usa `--set`, mostrar confirmación:
 ```
+Setting actualizado: auto-commit = true
 
-### Interactivo
+Antes: false
+Ahora: true
 
-```bash
-/elsabro:settings --interactive
+Efecto: ELSABRO hará commit automáticamente al completar tareas.
 ```
 
-```
-ELSABRO Settings Editor
+## Settings Reference
 
-Profile:
-  [1] default (current)
-  [2] yolo
-  [3] careful
+### Profile Settings
 
-Select (1-3): 2
+| Setting | Values | Qué Hace |
+|---------|--------|----------|
+| `profile` | default/yolo/careful | **Default**: Equilibrio velocidad/seguridad. **Yolo**: Máxima velocidad. **Careful**: Máxima seguridad. |
+| `language` | en/es | Idioma de todas las respuestas y sugerencias de ELSABRO. |
+| `experience` | beginner/intermediate/expert | **Beginner**: Explicaciones detalladas. **Intermediate**: Explicaciones cuando necesario. **Expert**: Respuestas directas. |
 
-Workflow - Auto-commit:
-  [ ] false (current)
-  [x] true
+### Workflow Settings
 
-Enable auto-commit? (y/n): y
+| Setting | Values | Qué Hace |
+|---------|--------|----------|
+| `auto-commit` | true/false | **true**: Commit automático al terminar. **false**: Te pregunta antes. |
+| `auto-tests` | true/false | **true**: Corre tests después de cada cambio. **false**: Tests manuales. |
+| `parallel-agents` | true/false | **true**: 2-4 agentes trabajando simultáneamente (más rápido). **false**: Un agente a la vez. |
+| `default-flow` | standard/quick/yolo | **Standard**: Plan→Ejecutar→Verificar. **Quick**: Ejecutar directo. **Yolo**: Sin verificación. |
+| `agent-teams` | true/false | **true**: Usa Agent Teams (TeamCreate) para coordinación paralela. **false**: Subagentes independientes. |
+| `blocking-review` | true/false | **true**: Code review obligatorio, no se puede saltar. **false**: Review opcional. |
 
-...
+### Integration Settings
 
-Settings updated!
-```
+| Setting | Values | Qué Hace |
+|---------|--------|----------|
+| `context7` | true/false | Busca documentación actualizada de librerías automáticamente. |
+| `21st-dev` | true/false | Acceso a componentes UI premium de 21st.dev. |
+| `stitch-mcp` | true/false | Diseño de UI con IA usando Stitch MCP. |
+| `pinecone` | true/false | Búsqueda semántica en tu código con Pinecone. |
+| `playwright` | true/false | Testing automatizado de browser/UI. |
+| `persistent-mode` | true/false | ELSABRO siempre activo, rutea mensajes automáticamente. |
+| `skill-discovery` | true/false | Busca y sugiere skills relevantes automáticamente. |
 
-## Almacenamiento
+### Output Settings
 
-Settings guardados en `.elsabro/config.json`:
-
-```json
-{
-  "profile": "default",
-  "language": "es",
-  "experience": "intermediate",
-  "workflow": {
-    "auto-commit": false,
-    "auto-tests": true,
-    "parallel-agents": true,
-    "default-flow": "standard"
-  },
-  "integrations": {
-    "context7": true,
-    "21st-dev": true,
-    "git-hooks": false
-  },
-  "output": {
-    "verbosity": "normal",
-    "colors": true,
-    "diagrams": "mermaid"
-  }
-}
-```
+| Setting | Values | Qué Hace |
+|---------|--------|----------|
+| `verbosity` | quiet/normal/verbose | **Quiet**: Solo lo esencial. **Normal**: Balance. **Verbose**: Máximo detalle. |
+| `colors` | true/false | Usar colores en el output de terminal. |
+| `diagrams` | mermaid/ascii/none | **Mermaid**: Diagramas visuales. **ASCII**: Texto plano. **None**: Sin diagramas. |
 
-## Integración
+## Almacenamiento
 
-- Profiles con `/elsabro:set-profile`
-- Affects all ELSABRO commands
-- Project-level config in `.elsabro/`
+Settings guardados en `.elsabro/config.json`. Este archivo se crea SOLO después de completar el wizard (nunca con defaults silenciosos).
 
 <siguiente_paso>
 ## Siguiente Paso

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "elsabro",
-  "version": "4.2.0",
+  "version": "4.2.1",
   "description": "Sistema de desarrollo AI-powered para Claude Code - Next Step Suggestions, Stitch UI Design, Agent Teams, blocking code review, orquestación avanzada con checkpointing, memoria multi-nivel y flows declarativos",
   "bin": {
     "elsabro": "bin/install.js"