elsabro 2.1.0 → 2.3.0

package/commands/elsabro/check-todos.md

@@ -1,6 +1,12 @@
 ---
 name: check-todos
 description: Ver y gestionar el todo list del proyecto
+allowed-tools:
+  - TaskList
+  - TaskGet
+  - TaskUpdate
+  - Read
+  - AskUserQuestion
 ---
 
 # /elsabro:check-todos
@@ -9,7 +15,7 @@ description: Ver y gestionar el todo list del proyecto
 
 ## Propósito
 
-Revisar, filtrar y gestionar los TODOs del proyecto. Vista completa de tareas pendientes.
+Revisar, filtrar y gestionar los TODOs del proyecto usando **Claude Code Tasks API**. Vista completa de tareas pendientes con capacidad de gestión directa.
 
 ## Cuándo Usar
 
@@ -45,7 +51,69 @@ Revisar, filtrar y gestionar los TODOs del proyecto. Vista completa de tareas pe
 /elsabro:check-todos --completed
 ```
 
-## Vista Principal
+---
+
+## Implementación (Tasks API)
+
+<implementation>
+Cuando el usuario ejecuta `/elsabro:check-todos`:
+
+### 1. Obtener TODOs
+
+```javascript
+// Listar todas las Tasks
+const allTasks = TaskList();
+
+// Filtrar por tipo "todo"
+const todos = allTasks.filter(t => t.metadata?.type === "todo");
+```
+
+### 2. Aplicar Filtros
+
+```javascript
+// Si --priority especificado
+if (args.priority) {
+  todos = todos.filter(t => t.metadata?.priority === args.priority);
+}
+
+// Si --category especificado
+if (args.category) {
+  todos = todos.filter(t => t.metadata?.category === args.category);
+}
+
+// Si --pending (default)
+if (args.pending || !args.completed) {
+  todos = todos.filter(t => t.status !== "completed");
+}
+
+// Si --completed
+if (args.completed) {
+  todos = todos.filter(t => t.status === "completed");
+}
+
+// Si --overdue
+if (args.overdue) {
+  const now = new Date();
+  todos = todos.filter(t =>
+    t.metadata?.due_date &&
+    new Date(t.metadata.due_date) < now &&
+    t.status !== "completed"
+  );
+}
+```
+
+### 3. Agrupar por Prioridad
+
+```javascript
+const grouped = {
+  critical: todos.filter(t => t.metadata?.priority === "critical"),
+  high: todos.filter(t => t.metadata?.priority === "high"),
+  medium: todos.filter(t => t.metadata?.priority === "medium"),
+  low: todos.filter(t => t.metadata?.priority === "low")
+};
+```
+
+### 4. Mostrar Vista
 
 ```
 ╔══════════════════════════════════════════════════╗
@@ -53,75 +121,144 @@ Revisar, filtrar y gestionar los TODOs del proyecto. Vista completa de tareas pe
 ╠══════════════════════════════════════════════════╣
 ║                                                  ║
 ║  🔴 CRITICAL (1)                                 ║
-║  #1 Fix auth token refresh [bug]                ║
+║  #<ID> Fix auth token refresh [bug]              ║
 ║                                                  ║
 ║  🟠 HIGH (3)                                     ║
-║  #2 Update React to v18.3 [tech-debt]           ║
-║  #3 Add loading states [ux]                     ║
-║  #4 Update error messages [ux]                  ║
+║  #<ID> Update React to v18.3 [tech-debt]        ║
+║  #<ID> Add loading states [ux]                  ║
+║  #<ID> Update error messages [ux]               ║
 ║                                                  ║
 ║  🟡 MEDIUM (4)                                   ║
-║  #5 Fix typo in README [docs]                   ║
-║  #6 Add error boundary [tech-debt]              ║
-║  #7 Document API endpoints [docs]               ║
-║  #8 Add unit tests for utils [test]             ║
+║  #<ID> Fix typo in README [docs]                ║
+║  #<ID> Add error boundary [tech-debt]           ║
+║  #<ID> Document API endpoints [docs]            ║
+║  #<ID> Add unit tests for utils [test]          ║
 ║                                                  ║
 ║  ⬜ LOW (2)                                      ║
-║  #9 Investigate dark mode [idea]                ║
-║  #10 Consider PWA support [idea]                ║
+║  #<ID> Investigate dark mode [idea]             ║
+║  #<ID> Consider PWA support [idea]              ║
 ║                                                  ║
 ╠══════════════════════════════════════════════════╣
 ║  Total: 10 | Completed today: 2                  ║
 ╚══════════════════════════════════════════════════╝
 ```
+</implementation>
+
+---
 
 ## Gestión de TODOs
 
-### Marcar como completado
+### Marcar como Completado
 
 ```bash
-/elsabro:check-todos --complete=5
+/elsabro:check-todos --complete=<task-id>
 ```
 
+```javascript
+TaskUpdate({
+  taskId: "<task-id>",
+  status: "completed",
+  metadata: {
+    completed_at: new Date().toISOString()
+  }
+});
 ```
-✓ Completed: #5 "Fix typo in README"
+
+Output:
+```
+✓ Completed: #<ID> "Fix typo in README"
 ```
 
-### Cambiar prioridad
+### Cambiar Prioridad
 
 ```bash
-/elsabro:check-todos --prioritize=6 --to=high
+/elsabro:check-todos --prioritize=<task-id> --to=high
+```
+
+```javascript
+// Obtener task actual
+const task = TaskGet({ taskId: "<task-id>" });
+
+// Actualizar prioridad en metadata
+TaskUpdate({
+  taskId: "<task-id>",
+  metadata: {
+    ...task.metadata,
+    priority: "high",
+    updated_at: new Date().toISOString()
+  }
+});
 ```
 
+Output:
 ```
-✓ #6 "Add error boundary" priority: medium → high
+✓ #<ID> "Add error boundary" priority: medium → high
 ```
 
 ### Eliminar TODO
 
 ```bash
-/elsabro:check-todos --delete=9
+/elsabro:check-todos --delete=<task-id>
+```
+
+```javascript
+// Confirmar con usuario
+AskUserQuestion({
+  questions: [{
+    question: `Delete #<ID> "${task.subject}"?`,
+    header: "Confirm",
+    options: [
+      { label: "Yes, delete", description: "Permanently remove this TODO" },
+      { label: "No, keep it", description: "Cancel deletion" }
+    ],
+    multiSelect: false
+  }]
+});
+
+// Si confirmado
+TaskUpdate({ taskId: "<task-id>", status: "deleted" });
 ```
 
+Output:
 ```
-Delete #9 "Investigate dark mode"? (y/n)
-> y
-✓ Deleted
+✓ Deleted: #<ID> "Investigate dark mode"
 ```
 
 ### Editar TODO
 
 ```bash
-/elsabro:check-todos --edit=3
+/elsabro:check-todos --edit=<task-id>
 ```
 
+```javascript
+// Obtener task actual
+const task = TaskGet({ taskId: "<task-id>" });
+
+// Solicitar nueva descripción
+AskUserQuestion({
+  questions: [{
+    question: `Current: "${task.subject}"\nNew description?`,
+    header: "Edit",
+    options: [
+      { label: "Keep current", description: "No changes" },
+      { label: "Modify", description: "Enter new description" }
+    ],
+    multiSelect: false
+  }]
+});
+
+// Si modifica
+TaskUpdate({
+  taskId: "<task-id>",
+  subject: newSubject,
+  metadata: {
+    ...task.metadata,
+    updated_at: new Date().toISOString()
+  }
+});
 ```
-Current: "Add loading states"
-New description (or Enter to keep):
-> Add loading states to all API calls
 
-✓ Updated #3
-```
+---
 
 ## Filtros
 
@@ -133,7 +270,7 @@ New description (or Enter to keep):
 --category=bug|tech-debt|docs|chore|idea|question
 
 # Por estado
---pending          # Solo pendientes
+--pending          # Solo pendientes (default)
 --completed        # Solo completados
 --overdue          # Con fecha vencida
 
@@ -145,12 +282,47 @@ New description (or Enter to keep):
 --milestone=M001
 ```
 
+---
+
 ## Estadísticas
 
 ```bash
 /elsabro:check-todos --stats
 ```
 
+<stats_implementation>
+```javascript
+const todos = TaskList().filter(t => t.metadata?.type === "todo");
+const pending = todos.filter(t => t.status !== "completed");
+const completed = todos.filter(t => t.status === "completed");
+
+// Por prioridad
+const byPriority = {
+  critical: pending.filter(t => t.metadata?.priority === "critical").length,
+  high: pending.filter(t => t.metadata?.priority === "high").length,
+  medium: pending.filter(t => t.metadata?.priority === "medium").length,
+  low: pending.filter(t => t.metadata?.priority === "low").length
+};
+
+// Por categoría
+const byCategory = pending.reduce((acc, t) => {
+  const cat = t.metadata?.category || "uncategorized";
+  acc[cat] = (acc[cat] || 0) + 1;
+  return acc;
+}, {});
+
+// Completion rate (últimos 7 días)
+const sevenDaysAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000);
+const recentlyCompleted = completed.filter(t =>
+  new Date(t.metadata?.completed_at) > sevenDaysAgo
+);
+const completionRate = Math.round(
+  (recentlyCompleted.length / (recentlyCompleted.length + pending.length)) * 100
+);
+```
+</stats_implementation>
+
+Output:
 ```
 ╔══════════════════════════════════════════════════╗
 ║  TODO STATISTICS                                 ║
@@ -172,6 +344,8 @@ New description (or Enter to keep):
 ╚══════════════════════════════════════════════════╝
 ```
 
+---
+
 ## Output Formatos
 
 ```bash
@@ -185,8 +359,13 @@ New description (or Enter to keep):
 /elsabro:check-todos --format=minimal
 ```
 
+---
+
 ## Integración
 
 - Add with `/elsabro:add-todo`
-- Syncs with `.planning/TODOS.md`
-- Can promote to phase with actions
+- Backend: Claude Code Tasks API
+- Persiste entre sesiones
+- Soporta dependencias (`blocks/blockedBy`)
+- Visible en `/elsabro:progress`
+- Promovible a fase con `/elsabro:add-phase`

package/commands/elsabro/complete-milestone.md

@@ -1,10 +1,29 @@
 ---
 name: complete-milestone
-description: Cerrar un milestone completado con retrospectiva y documentación de logros
+description: Cerrar un milestone completado con retrospectiva y documentacion de logros
+sync:
+  reads: [".elsabro/state.json"]
+  writes: [".elsabro/state.json", ".elsabro/context.md"]
 ---
 
 # /elsabro:complete-milestone
 
+<state_sync>
+## SINCRONIZACION DE ESTADO
+
+**IMPORTAR**: Ver `/references/state-sync.md` para protocolo completo.
+
+### Al Iniciar
+- Leer `.elsabro/state.json`
+- Verificar si hay flujo en progreso
+- Actualizar `current_flow.command` con este comando
+
+### Al Completar
+- Registrar en `history`
+- Actualizar `context` con informacion del milestone
+- Limpiar `current_flow`
+</state_sync>
+
 <command-name>complete-milestone</command-name>
 
 ## Propósito

package/commands/elsabro/debug.md

@@ -13,10 +13,29 @@ allowed-tools:
   - AskUserQuestion
   - mcp__plugin_context7_context7__*
 argument-hint: "[descripción del problema]"
+sync:
+  reads: [".elsabro/state.json"]
+  writes: [".elsabro/state.json", ".elsabro/context.md"]
 ---
 
 # ELSABRO: Debug
 
+<state_sync>
+## SINCRONIZACION DE ESTADO
+
+**IMPORTAR**: Ver `/references/state-sync.md` para protocolo completo.
+
+### Al Iniciar
+- Leer `.elsabro/state.json`
+- Verificar si hay flujo en progreso
+- Actualizar `current_flow.command` con este comando
+
+### Al Completar
+- Registrar en `history`
+- Actualizar `context` con informacion relevante
+- Limpiar `current_flow`
+</state_sync>
+
 <objective>
 Investigar y resolver bugs usando el método científico, no adivinando.
 

package/commands/elsabro/discuss-phase.md

@@ -1,10 +1,27 @@
 ---
 name: discuss-phase
-description: Discusión colaborativa sobre una fase - clarificar scope, identificar riesgos, refinar approach
+description: Discusion colaborativa sobre una fase - clarificar scope, identificar riesgos, refinar approach
+sync:
+  reads: [".elsabro/state.json"]
+  writes: [".elsabro/state.json"]
 ---
 
 # /elsabro:discuss-phase
 
+<state_sync>
+## SINCRONIZACION DE ESTADO
+
+**IMPORTAR**: Ver `/references/state-sync.md` para protocolo completo.
+
+### Al Iniciar
+- Leer `.elsabro/state.json`
+- Verificar contexto actual del milestone/phase
+
+### Al Completar
+- Registrar cambio en `history`
+- Actualizar `context` si corresponde
+</state_sync>
+
 <command-name>discuss-phase</command-name>
 
 ## Propósito