elsabro 2.0.1 → 2.2.0

package/commands/elsabro/progress.md

@@ -2,6 +2,8 @@
 name: progress
 description: Ver el progreso del proyecto y qué hacer siguiente
 allowed-tools:
+  - TaskList
+  - TaskGet
   - Read
   - Glob
   - Grep
@@ -11,134 +13,175 @@ allowed-tools:
 # ELSABRO: Progress
 
 <objective>
-Mostrar el estado actual del proyecto y guiar al usuario sobre qué hacer a continuación.
+Mostrar el estado actual del proyecto y guiar al usuario sobre qué hacer a continuación usando **Claude Code Tasks API** como fuente de verdad.
 </objective>
 
 <process>
-## Paso 1: Detectar Estado del Proyecto
-
-```bash
-# Verificar si hay proyecto ELSABRO
-ls .planning/ 2>/dev/null
+## Paso 1: Cargar Estado desde Tasks API
+
+```javascript
+// Obtener todas las tasks
+const allTasks = TaskList();
+
+// Filtrar por tipo
+const milestones = allTasks.filter(t => t.metadata?.type === "milestone");
+const phases = allTasks.filter(t => t.metadata?.type === "phase");
+const todos = allTasks.filter(t => t.metadata?.type === "todo");
+const work = allTasks.filter(t => t.metadata?.type === "work");
+
+// Estado actual
+const inProgress = allTasks.filter(t => t.status === "in_progress");
+const pending = allTasks.filter(t => t.status === "pending");
+const completed = allTasks.filter(t => t.status === "completed");
+const blocked = allTasks.filter(t => t.blockedBy?.length > 0);
 ```
 
-### Si no existe .planning/
+### Si no hay tasks
 ```
-No hay un proyecto ELSABRO en este directorio.
+No hay tareas registradas en este proyecto.
 
-¿Quieres empezar uno nuevo?
+¿Quieres empezar?
 → /elsabro:start
 ```
 
-### Si existe .planning/
+### Si hay tasks
 Continuar a Paso 2.
 
-## Paso 2: Cargar Contexto
-
-Leer estos archivos si existen:
-- `.planning/PROJECT.md` → Información del proyecto
-- `.planning/ROADMAP.md` → Fases planificadas
-- `.planning/config.json` → Configuración
-- `.planning/*-VERIFICATION.md` → Estados de verificación
-
-## Paso 3: Calcular Progreso
-
-```
-Para cada fase en ROADMAP:
-  - ¿Tiene PLAN.md? → Planificada
-  - ¿Tiene SUMMARY.md? → Ejecutada
-  - ¿Tiene VERIFICATION.md con passed? → Completada
-  - ¿Tiene gaps? → Necesita corrección
+## Paso 2: Calcular Progreso
+
+```javascript
+// Progreso general
+const totalTasks = allTasks.length;
+const completedTasks = completed.length;
+const progressPercent = Math.round((completedTasks / totalTasks) * 100);
+
+// Por milestone
+const milestoneProgress = milestones.map(m => {
+  const phasesInMilestone = phases.filter(p =>
+    p.metadata?.milestone_id === m.metadata?.milestone_id
+  );
+  const completedPhases = phasesInMilestone.filter(p => p.status === "completed");
+  return {
+    name: m.subject,
+    progress: Math.round((completedPhases.length / phasesInMilestone.length) * 100),
+    phases: phasesInMilestone
+  };
+});
 ```
 
-## Paso 4: Mostrar Resumen
+## Paso 3: Mostrar Resumen
 
 ```
 ┌─────────────────────────────────────────────┐
-│  [Nombre del Proyecto]                       │
-│  [Descripción corta]                         │
+│  [Milestone Actual]                          │
+│  [Descripción]                               │
 └─────────────────────────────────────────────┘
 
 Progreso: ████████░░ 80%
 
-Fases:
-  ✓ Fase 1: Setup inicial
-  ✓ Fase 2: Autenticación
-  → Fase 3: Dashboard (en progreso)
-  ○ Fase 4: Pagos
-  ○ Fase 5: Deploy
+Phases:
+  ✓ Phase 1: Setup inicial
+  ✓ Phase 2: Autenticación
+  → Phase 3: Dashboard (en progreso)
+  ○ Phase 4: Pagos
+  ○ Phase 5: Deploy
+
+TODOs pendientes: 5 (2 high, 3 medium)
+Tareas bloqueadas: 1
 
 Última actividad: hace 2 horas
-Último commit: feat(3-1): Add dashboard layout
+```
+
+## Paso 4: Mostrar Trabajo Actual
+
+```javascript
+// Tareas en progreso
+const currentWork = inProgress.map(t => ({
+  id: t.id,
+  subject: t.subject,
+  type: t.metadata?.type,
+  owner: t.owner || "unassigned"
+}));
+```
+
+```
+📍 En progreso ahora:
+  #<ID> Implement user dashboard [work]
+  #<ID> Fix auth token refresh [todo]
+
+⏸️ Bloqueado:
+  #<ID> Deploy to production (blocked by #<ID>)
 ```
 
 ## Paso 5: Sugerir Siguiente Acción
 
-Basado en el estado:
+### Si hay work in_progress:
+```
+Continúa con el trabajo actual:
+→ /elsabro:execute (para continuar implementación)
+→ /elsabro:verify-work (si crees que terminaste)
+```
 
-### Si hay fase en progreso sin completar:
+### Si hay TODOs high priority:
 ```
-Siguiente paso recomendado:
-→ Continuar fase 3: /elsabro:execute 3
+TODOs de alta prioridad pendientes:
+#<ID> Update error messages [high]
+#<ID> Fix validation bug [high]
 
-O si necesitas ayuda:
-→ Ver el plan: cat .planning/3-PLAN.md
-→ Depurar problema: /elsabro:debug
+→ /elsabro:check-todos (ver todos)
+→ /elsabro:quick "<TODO>" (resolver uno rápido)
 ```
 
-### Si la última fase está completada:
+### Si la última phase está completada:
 ```
 ¡Excelente progreso!
 
-Siguiente paso recomendado:
-→ Planificar fase 4: /elsabro:plan 4
-
-O alternativamente:
-→ Verificar todo: /elsabro:verify
-→ Ver el roadmap: cat .planning/ROADMAP.md
+Siguiente phase disponible:
+→ /elsabro:plan (planificar siguiente)
+→ /elsabro:add-phase (agregar nueva phase)
 ```
 
-### Si hay gaps pendientes:
+### Si hay tasks bloqueadas:
 ```
-⚠ Hay problemas pendientes en fase 3
+⚠ Hay trabajo bloqueado
 
-Gaps encontrados:
-- [ ] Test de validación fallando
-- [ ] Falta middleware de auth
+#<ID> Deploy to production
+   Bloqueado por: #<ID> Complete security audit
 
-Siguiente paso recomendado:
-→ Corregir gaps: /elsabro:debug
-→ Ver detalles: cat .planning/3-VERIFICATION.md
+Opciones:
+→ Ver detalles: TaskGet #<ID>
+→ Resolver bloqueador: /elsabro:execute
+→ Desbloquear manualmente: /elsabro:check-todos --complete=<ID>
 ```
 
-### Si el proyecto está completo:
+### Si todo está completado:
 ```
-🎉 ¡Proyecto completado!
+🎉 ¡Milestone completado!
 
-Todas las fases verificadas:
-✓ Fase 1: Setup inicial
-✓ Fase 2: Autenticación
-✓ Fase 3: Dashboard
-✓ Fase 4: Pagos
-✓ Fase 5: Deploy
+Todas las phases verificadas:
+✓ Phase 1: Setup inicial
+✓ Phase 2: Autenticación
+✓ Phase 3: Dashboard
+✓ Phase 4: Pagos
+✓ Phase 5: Deploy
 
 Opciones:
-→ Agregar nueva feature: /elsabro:plan "nueva feature"
-→ Revisar código: Ver archivos
-→ Actualizar ELSABRO: /elsabro:update
+→ Crear nuevo milestone: /elsabro:new-milestone
+→ Agregar feature: /elsabro:plan "nueva feature"
+→ Ver TODOs pendientes: /elsabro:check-todos
 ```
 </process>
 
 <visual_indicators>
 ## Indicadores Visuales
 
-| Símbolo | Significado |
-|---------|-------------|
-| ✓ | Completado y verificado |
-| → | En progreso actual |
-| ○ | Pendiente |
-| ⚠ | Tiene problemas/gaps |
-| ✗ | Falló verificación |
+| Símbolo | Significado | Task Status |
+|---------|-------------|-------------|
+| ✓ | Completado | completed |
+| → | En progreso | in_progress |
+| ○ | Pendiente | pending |
+| ⏸️ | Bloqueado | pending + blockedBy |
+| ✗ | Fallido | failed (metadata) |
 
 ## Barra de Progreso
 
@@ -151,6 +194,53 @@ Opciones:
 ```
 </visual_indicators>
 
+<tasks_summary>
+## Resumen por Tipo de Task
+
+```javascript
+const summary = {
+  milestones: {
+    total: milestones.length,
+    completed: milestones.filter(t => t.status === "completed").length,
+    inProgress: milestones.filter(t => t.status === "in_progress").length
+  },
+  phases: {
+    total: phases.length,
+    completed: phases.filter(t => t.status === "completed").length,
+    inProgress: phases.filter(t => t.status === "in_progress").length
+  },
+  todos: {
+    total: todos.length,
+    critical: todos.filter(t => t.metadata?.priority === "critical").length,
+    high: todos.filter(t => t.metadata?.priority === "high").length,
+    completed: todos.filter(t => t.status === "completed").length
+  },
+  work: {
+    total: work.length,
+    inProgress: work.filter(t => t.status === "in_progress").length,
+    completed: work.filter(t => t.status === "completed").length
+  }
+};
+```
+
+Output:
+```
+╔══════════════════════════════════════════════════╗
+║  PROJECT SUMMARY                                 ║
+╠══════════════════════════════════════════════════╣
+║                                                  ║
+║  Milestones: 1/2 completed                       ║
+║  Phases:     4/5 completed                       ║
+║  TODOs:      8 pending (2 critical, 3 high)     ║
+║  Work items: 3 in progress                       ║
+║                                                  ║
+║  Blocked: 1 task                                 ║
+║  Dependencies: 5 total                           ║
+║                                                  ║
+╚══════════════════════════════════════════════════╝
+```
+</tasks_summary>
+
 <context_awareness>
 ## Consciencia de Contexto
 
@@ -173,15 +263,49 @@ Recomendación:
 ```
 
 ### Tiempo desde última actividad
+```javascript
+// Encontrar última task actualizada
+const lastUpdated = allTasks
+  .filter(t => t.metadata?.updated_at)
+  .sort((a, b) => new Date(b.metadata.updated_at) - new Date(a.metadata.updated_at))[0];
+
+const hoursSince = (Date.now() - new Date(lastUpdated.metadata.updated_at)) / (1000 * 60 * 60);
+
+if (hoursSince > 24) {
+  // Mostrar contexto de última sesión
+}
+```
+
 Si han pasado más de 24 horas:
 ```
 Ha pasado tiempo desde tu última sesión.
 
 Resumen de dónde te quedaste:
-- Fase actual: [N]
-- Última tarea: [descripción]
-- Estado: [pendiente/en progreso]
+- Última task: #<ID> Implement dashboard
+- Estado: in_progress
+- Hace: 2 días
 
 ¿Quieres continuar donde lo dejaste?
+→ /elsabro:resume-work
 ```
 </context_awareness>
+
+<state_sync>
+## State Sync (Tasks API)
+
+Este comando es READ-ONLY - no modifica tasks, solo consulta.
+
+```javascript
+// Lectura de estado (NO escritura)
+const state = {
+  tasks: TaskList(),
+  current: TaskList().find(t => t.status === "in_progress"),
+  blocked: TaskList().filter(t => t.blockedBy?.length > 0)
+};
+```
+
+Si necesitas actualizar estado, usa otros comandos:
+- `/elsabro:pause-work` - Guardar contexto
+- `/elsabro:resume-work` - Retomar trabajo
+- `/elsabro:check-todos` - Gestionar TODOs
+</state_sync>

package/commands/elsabro/quick.md

@@ -1,10 +1,29 @@
 ---
 name: quick
 description: Modo de ejecución rápida para tareas simples - mínima ceremonia, máxima velocidad
+sync:
+  reads: [".elsabro/state.json"]
+  writes: [".elsabro/state.json", ".elsabro/context.md"]
 ---
 
 # /elsabro:quick
 
+<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>
+
 <command-name>quick</command-name>
 
 ## Propósito

package/commands/elsabro/remove-phase.md

@@ -1,10 +1,27 @@
 ---
 name: remove-phase
 description: Eliminar una fase del milestone (con validaciones de seguridad)
+sync:
+  reads: [".elsabro/state.json"]
+  writes: [".elsabro/state.json"]
 ---
 
 # /elsabro:remove-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>remove-phase</command-name>
 
 ## Propósito

package/commands/elsabro/research-phase.md

@@ -1,10 +1,27 @@
 ---
 name: research-phase
-description: Investigar tecnologías, patrones y approaches para una fase antes de planificar
+description: Investigar tecnologias, patrones y approaches para una fase antes de planificar
+sync:
+  reads: [".elsabro/state.json"]
+  writes: [".elsabro/state.json"]
 ---
 
 # /elsabro:research-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>research-phase</command-name>
 
 ## Propósito

package/commands/elsabro/resume-work.md

@@ -7,15 +7,81 @@ allowed-tools:
   - Bash
   - Glob
   - Grep
+  - TaskGet
+  - TaskUpdate
+  - TaskList
+  - TaskCreate
+sync:
+  reads: [".elsabro/state.json"]
+  writes: [".elsabro/state.json", ".elsabro/context.md"]
 ---
 
 # /elsabro:resume-work
 
+<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>
+
 <command-name>resume-work</command-name>
 
 ## Propósito
 
-Retomar trabajo en un proyecto después de una interrupción. Reconstruye contexto, muestra estado actual y sugiere siguiente paso.
+Retomar trabajo en un proyecto después de una interrupción. Reconstruye contexto desde Tasks API, muestra estado actual y sugiere siguiente paso.
+
+## Integración con Tasks API
+
+Al reanudar, primero consultar el sistema de Tasks para recuperar contexto:
+
+```javascript
+// 1. Listar todas las tasks para ver estado actual
+TaskList()
+// Output:
+//   ⏸ User profile page - Paused (metadata.status: "paused")
+//   ✅ Dashboard layout - Completed
+//   ⏳ Settings modal - Pending
+
+// 2. Obtener detalles de la task pausada
+TaskGet({ taskId: "paused-task-id" })
+// Output:
+//   status: "in_progress" (pero metadata.status: "paused")
+//   metadata: {
+//     pausedAt: "2024-01-20T17:30:00Z",
+//     expectedReturn: "2024-01-21T09:00:00Z",
+//     lastCompletedSubtask: "validation-implementation",
+//     nextSubtask: "avatar-upload",
+//     notes: "Zod schema completo, falta avatar"
+//   }
+
+// 3. Validar integridad del contexto
+// - ¿Tiempo desde pausa > 7 días? → Warning
+// - ¿Tiempo > 30 días? → Sugerir revisión completa
+// - ¿Archivos referenciados aún existen?
+
+// 4. Reactivar task
+TaskUpdate({
+  taskId: "paused-task-id",
+  metadata: {
+    status: "active",  // Ya no está pausada
+    resumedAt: "2024-01-21T09:15:00Z",
+    resumedFrom: "pause"
+  }
+})
+
+// 5. Eliminar reminder si existe
+TaskUpdate({ taskId: "reminder-task-id", status: "deleted" })
+```
 
 ## Uso
 
@@ -151,9 +217,71 @@ Implementing user profile validation
 ## Integración
 
 - Paired con `/elsabro:pause-work`
-- Uses session data from `.planning/SESSION.md`
+- **Tasks API** como fuente primaria de estado
+- Uses session data from `.planning/SESSION.md` como fallback
 - Can trigger `/elsabro:progress` for overview
 
+### Flujo de Recuperación con Tasks
+
+```javascript
+// Prioridad de fuentes de contexto:
+// 1. Tasks API (TaskGet) → Más confiable, persistente entre sesiones
+// 2. SESSION-STATE.json → Backup para detalles adicionales
+// 3. SESSION.md → Fallback humano-legible
+
+async function resumeWork() {
+  // 1. Intentar recuperar de Tasks
+  const tasks = await TaskList()
+  const pausedTask = tasks.find(t => t.metadata?.status === "paused")
+
+  if (pausedTask) {
+    const details = await TaskGet({ taskId: pausedTask.id })
+
+    // Reactivar task principal
+    await TaskUpdate({
+      taskId: pausedTask.id,
+      metadata: { ...details.metadata, status: "active", resumedAt: new Date() }
+    })
+
+    // Buscar y eliminar reminder task asociada
+    const reminderTask = tasks.find(t =>
+      t.metadata?.type === "reminder" &&
+      t.metadata?.pausedTaskId === pausedTask.id
+    )
+    if (reminderTask) {
+      await TaskUpdate({ taskId: reminderTask.id, status: "deleted" })
+    }
+
+    // Mostrar metadatos recuperados al usuario
+    console.log(`Recovered context:
+      - Last completed: ${details.metadata.lastCompletedSubtask}
+      - Next step: ${details.metadata.nextSubtask}
+      - Notes: ${details.metadata.notes}
+    `)
+
+    return details
+  }
+
+  // 2. Fallback a SESSION-STATE.json
+  if (fs.existsSync('.planning/SESSION-STATE.json')) {
+    // ... recuperar de archivo ...
+  }
+
+  // 3. Fallback final a SESSION.md
+  // ...
+}
+```
+
+### Ventajas de Tasks API para Resume
+
+| Aspecto | Antes (archivos) | Ahora (Tasks API) |
+|---------|------------------|-------------------|
+| Persistencia | Solo en proyecto | Entre sesiones |
+| Recuperación | Parse manual | TaskGet directo |
+| Integridad | Validar JSON | Sistema garantiza |
+| Visibilidad | Leer archivo | Ctrl+T nativo |
+| Staleness | Calcular manual | Metadata timestamps |
+
 <session_validation>
 ## Validación de Sesión