@saulwade/swl-ses 1.0.0

package/comandos/swl/sesiones.md

@@ -0,0 +1,200 @@
+---
+name: swl:sesiones
+description: Gestiona el historial de sesiones SWL (listar, resumir, inspeccionar la sesión activa y generar continue-here.md desde cualquier sesión pasada)
+allowed_tools: ["Read", "Write", "Bash", "Glob"]
+---
+
+# /swl:sesiones — Gestionar historial de sesiones SWL
+
+Administra las sesiones de trabajo persistidas en `.planning/sessions/`.
+Cada sesión registra tool calls, costo estimado, archivos modificados y agentes invocados.
+
+## Uso
+
+```
+/swl:sesiones              — Lista las últimas 10 sesiones
+/swl:sesiones list [N]     — Lista las últimas N sesiones
+/swl:sesiones resume [id]  — Genera continue-here.md desde una sesión
+/swl:sesiones inspect [id] — Muestra detalle completo de una sesión
+/swl:sesiones active       — Muestra la sesión activa actual
+/swl:sesiones wake [id]    — Reconstruye estado de sesión desde eventos JSONL (Managed Agents wake pattern)
+```
+
+## Comportamiento por subcomando
+
+### list [N]
+
+1. Leer todos los archivos `ses-*.json` en `.planning/sessions/`.
+2. Ordenar por nombre de archivo descendente (el nombre encode el timestamp).
+3. Aplicar límite: 10 por defecto, o el N proporcionado.
+4. Mostrar tabla compacta:
+
+```
+| ID                  | Fecha      | Modo | Tool Calls | Costo  | Estado    |
+|---------------------|------------|------|------------|--------|-----------|
+| ses-20260331-143000 | 2026-03-31 | dev  | 47         | $1.87  | completed |
+| ses-20260331-093000 | 2026-03-31 | dev  | 23         | $0.69  | completed |
+```
+
+Si `.planning/sessions/` no existe o está vacío, mostrar:
+```
+No hay sesiones registradas en .planning/sessions/
+```
+
+### resume [id]
+
+1. Si no se proporciona `id`, usar la sesión de `.planning/sessions/latest.json`.
+2. Si se proporciona `id`, buscar el archivo `ses-{id}.json` o `{id}.json` en `.planning/sessions/`.
+3. Leer el objeto de sesión.
+4. Construir el contenido del continue-here.md con esta estructura:
+
+```markdown
+# Continue Here — {id}
+
+**Sesión**: {id}
+**Inicio**: {startTime}
+**Duración**: {N min | en progreso}
+**Modo**: {mode}
+**Tool calls**: {toolCalls}
+**Costo estimado**: ${costEstimated} USD
+
+## Archivos modificados
+- ruta/archivo1
+- ruta/archivo2
+
+## Agentes invocados
+- nombre-agente-1
+
+## Herramientas más usadas
+  - Bash: 21 llamadas
+  - Read: 15 llamadas
+
+## Resumen
+{summary o "(sin resumen)"}
+```
+
+5. Escribir el contenido en `.planning/continue-here.md`.
+6. Confirmar al usuario:
+```
+continue-here.md generado desde la sesión {id}.
+Archivo: .planning/continue-here.md
+```
+
+### inspect [id]
+
+1. Localizar el archivo de sesión igual que en `resume`.
+2. Mostrar TODOS los campos del JSON con formato legible:
+
+```
+Sesión: ses-20260331-143000
+Estado: completed
+Inicio: 2026-03-31T14:30:00.000Z
+Fin:    2026-03-31T16:45:00.000Z
+Modo:   dev
+
+Métricas generales:
+  Tool calls:      47
+  Tokens estimados: 23,500
+  Costo estimado:  $1.87 USD
+
+Herramientas:
+  Bash    21
+  Read    15
+  Write    6
+  Edit     3
+  Grep     2
+
+Modelos:
+  claude-sonnet-4-6   47
+
+Archivos modificados (6):
+  hooks/lib/session-store.js
+  comandos/swl/sesiones.md
+  ...
+
+Agentes invocados (2):
+  planificador-swl
+  backend-python-swl
+
+Resumen:
+  (sin resumen)
+```
+
+### active
+
+1. Leer `.planning/sessions/latest.json` para obtener el ID de la sesión activa.
+2. Leer el archivo de sesión correspondiente.
+3. Mostrar las métricas en tiempo real con el mismo formato de `inspect`.
+4. Si no hay sesión activa:
+```
+No hay sesión activa en este momento.
+Para iniciar una nueva sesión, el sistema la crea automáticamente al primer tool call.
+```
+
+### wake [id]
+
+Reconstruye el estado de una sesión desde su log de eventos JSONL en `.planning/runs/`.
+Implementa el patrón `wake(sessionId)` de Managed Agents: permite retomar sesiones
+interrumpidas sin recargar el contexto completo en la ventana del modelo.
+
+1. Si no se proporciona `id`, usar el ID de la sesión activa en `latest.json`.
+2. Buscar el archivo `.planning/runs/{id}.jsonl`.
+3. Leer el módulo `hooks/lib/run-log.js` para acceder a `wakeSession(id)`.
+4. Mostrar el estado reconstruido:
+
+```
+Sesión reconstruida: {id}
+Estado: {active|completed|aborted|unknown}
+
+Inicio:          {startTs}
+Último evento:   {lastTs}
+Tool calls:      {toolCalls}
+Último tool:     {lastToolCall}
+Abortada:        {sí|no}
+
+Agentes invocados ({N}):
+  - planificador-swl
+  - implementador-swl
+
+Skills cargados ({N}):
+  - ejecutar-fase
+  - git-workflow
+
+Contexto disponible en: .planning/runs/{id}.jsonl
+Para retomar: /swl:sesiones resume {id}
+```
+
+5. Si el archivo JSONL no existe pero sí existe `ses-{id}.json`, mostrar:
+```
+Run log no disponible para {id}. Usa /swl:sesiones inspect {id} para ver la sesión.
+```
+
+## Resolución de ID parcial
+
+Cuando el usuario proporciona un ID parcial (ej: `143000` o `20260331`), buscar el
+primer archivo `ses-*.json` cuyo nombre contenga ese fragmento. Si hay múltiples
+coincidencias, listarlas y pedir al usuario que especifique.
+
+## Datos persistidos por sesión
+
+Cada archivo `ses-YYYYMMDD-HHmmss.json` contiene:
+
+| Campo            | Tipo     | Descripción                                  |
+|------------------|----------|----------------------------------------------|
+| id               | string   | Identificador único de la sesión             |
+| startTime        | string   | ISO timestamp de inicio                      |
+| endTime          | string   | ISO timestamp de fin (null si activa)        |
+| status           | string   | `active` o `completed`                       |
+| mode             | string   | Modo activo (`dev`, `review`, `research`)    |
+| toolCalls        | number   | Total de invocaciones de herramientas        |
+| tokensEstimated  | number   | Suma de tokens estimados                     |
+| costEstimated    | number   | Costo acumulado en USD                       |
+| filesChanged     | string[] | Rutas de archivos modificados (deduplicados) |
+| agentsInvoked    | string[] | Nombres de agentes invocados (deduplicados)  |
+| summary          | string   | Resumen generado al cerrar la sesión         |
+| metricas         | object   | `{ herramientas: {}, modelos: {} }`          |
+
+## Directorio de sesiones
+
+`.planning/sessions/` — creado automáticamente por `session-store.js`.
+`latest.json` — puntero lógico a la sesión activa: `{ currentSession, path }`.

package/comandos/swl/skill-search.md

@@ -0,0 +1,113 @@
+---
+name: swl:skill-search
+description: Busca habilidades (skills) SWL disponibles por nombre o descripción. Genera o reutiliza el índice auto-descubierto de habilidades/*/SKILL.md. Cargar cuando el usuario quiera explorar skills disponibles, verificar si existe una habilidad concreta, o repasar el catálogo completo.
+allowed_tools: ["Bash", "Read"]
+---
+
+# /swl:skill-search — Explorar habilidades SWL
+
+Muestra el catálogo de habilidades disponibles en el sistema SWL.
+El índice se genera automáticamente leyendo `habilidades/*/SKILL.md`.
+
+## Uso
+
+```
+/swl:skill-search                  — Lista todas las habilidades
+/swl:skill-search <query>          — Filtra por nombre o descripción
+/swl:skill-search --intent <desc>  — Busca por intención (qué quiero hacer)
+/swl:skill-search --dominio <dom>  — Filtra por dominio (backend, frontend, etc.)
+/swl:skill-search --rebuild        — Regenera el índice desde disco
+```
+
+## Paso 1 — Verificar disponibilidad del script
+
+```bash
+ls scripts/lib/skill-discovery.js 2>/dev/null && echo "OK" || echo "FALTA"
+```
+
+Si falta, indicar al usuario que actualice SWL con `/swl:actualizar`.
+
+## Paso 2 — Ejecutar búsqueda o listar todo
+
+### Sin query (catálogo completo)
+
+```bash
+node scripts/lib/skill-discovery.js
+```
+
+### Con query (búsqueda filtrada)
+
+```bash
+node scripts/lib/skill-discovery.js "<query>"
+```
+
+Ejemplo: `node scripts/lib/skill-discovery.js "typescript"` muestra skills de TypeScript.
+
+### Búsqueda por intent (--intent)
+
+Cuando el usuario describe lo que quiere hacer en lugar de buscar por nombre técnico,
+usar la siguiente tabla de sinónimos para mapear intención → skills relevantes:
+
+| Intención del usuario | Keywords a buscar | Skills probables |
+|----------------------|-------------------|------------------|
+| "quiero hacer tests" | test, tdd, qa, cobertura | tdd-workflow, testing-* |
+| "necesito autenticación" | auth, login, jwt, oauth, sesión | auth-patrones |
+| "optimizar rendimiento" | performance, lento, caché, índice | performance-baseline |
+| "crear API" | api, rest, endpoint, graphql | api-rest-diseno, fastapi-experto |
+| "base de datos" | sql, query, migración, orm | postgresql-experto |
+| "desplegar" | deploy, ci, cd, docker, pipeline | ci-cd-pipelines |
+| "documentar" | docs, readme, changelog, adr | documentacion-tecnica |
+| "seguridad" | owasp, xss, inyección, csrf, secretos | seguridad-skills-ia |
+| "frontend" | componente, ui, css, react, angular | angular-moderno, frontend-* |
+| "errores" | error, debug, excepción, stack trace | manejo-errores |
+
+Si `--intent` está presente, buscar en la descripción de cada skill por coincidencia
+semántica con la intención expresada, no solo por string matching exacto.
+
+### Filtrar por dominio (--dominio)
+
+Dominios soportados: `backend`, `frontend`, `mobile`, `datos`, `infra`, `seguridad`,
+`ux`, `calidad`, `proceso`, `docs`.
+
+Filtra usando el prefijo de dominio del nombre del skill (ej: `backend-*`, `frontend-*`)
+o por las keywords del dominio en la descripción.
+
+### Reconstruir índice
+
+```bash
+node scripts/lib/skill-discovery.js --rebuild
+```
+
+## Paso 3 — Presentar resultados
+
+Mostrar la tabla generada por el script, que tiene el formato:
+
+```
+Habilidades SWL disponibles (N)
+──────────────────────────────────────────────────────────────────────
+  nombre-de-habilidad                       v1.0.0  Descripción breve
+  ...
+──────────────────────────────────────────────────────────────────────
+Generado: YYYY-MM-DD  |  Índice: .planning/skill-index.json
+```
+
+## Paso 4 — Cómo usar una habilidad
+
+Indicar al usuario la sintaxis para cargar la habilidad seleccionada:
+
+```
+Skill("nombre-de-habilidad")
+```
+
+Por ejemplo, si encontró `typescript-avanzado`:
+
+```
+Skill("typescript-avanzado")
+```
+
+## Notas
+
+- El índice persiste en `.planning/skill-index.json` entre sesiones.
+- Si una habilidad no tiene frontmatter YAML válido, aparece con su nombre de directorio.
+- Para ver detalles de una habilidad específica: `Read("habilidades/<nombre>/SKILL.md")`.
+- La descripción del índice viene del campo `description` en el frontmatter YAML del SKILL.md.