@saulwade/swl-ses 2.0.0 → 2.2.0

package/agentes/_propose-step.md

@@ -0,0 +1,90 @@
+<!--
+Fragmento compartido — Propose-step de adyacencias (Fase 13, ADR-0037)
+Importable desde frontmatter de agente: `fragmentos: [_propose-step]`
+Usar en orquestador-swl e implementador-swl. NO routable, NO invocable con Skill.
+Ver reglas/seguridad-agentes.md y .planning/adrs/0037-propose-step-presupuesto-autonomia.md
+-->
+
+## Propose-step — proponer adyacencias, nunca actuar
+
+Separa PROPONER de ACTUAR. Al **cerrar una tarea o fase** (no en cada turno),
+evalúas las adyacencias de riesgo del cambio y las emites como **anexo
+propositivo**. El anexo NUNCA bloquea ni ejecuta nada: es texto que el usuario
+lee y decide si actúa.
+
+### Cuándo correr
+
+- Solo al cerrar una tarea o una fase, sobre el diff de ese cierre.
+- Nunca en mitad de la implementación (evita ruido por turno).
+- Si `SWL_PROPOSE=0`, el propose-step queda desactivado: silencio total.
+
+### Cómo evaluar (mecanizado)
+
+Ejecuta la lib sobre el diff de la tarea/fase:
+
+```bash
+node hooks/lib/propose-step.js --rango=HEAD~1..HEAD
+```
+
+Imprime el anexo solo si detecta ≥1 señal; silencio si no hay nada. Si la lib
+no está disponible en el destino, evalúa a mano las 2 señales v1:
+
+- **auth/PII/pagos**: el diff toca autenticación, datos personales o pagos
+  (paths `auth/`, `login`, `session`; patrones `password`, `token`, `secret`,
+  `jwt`, `stripe`, `pago`, `curp`, `rfc`). → Sugerir revisión de seguridad y
+  tests de autorización.
+- **migración de schema**: el diff toca `models/`, `migrations/`, `*.sql`, o
+  contiene `ALTER/CREATE/DROP TABLE`. → Sugerir plan de rollback /
+  expand-contract y verificar reversibilidad.
+
+### Formato del anexo
+
+Solo cuando hay señal. Una sección al final del entregable:
+
+```
+## Anexo propositivo — adyacencias de riesgo
+
+Sugerencias, no acciones: nada se ejecuta ni se bloquea automáticamente.
+
+- [auth-pii-pagos] <título> (<evidencia>) → <acción sugerida>
+```
+
+Las categorías que la telemetría de aceptación silenció (el usuario las ignora
+de forma sostenida) no copan el anexo. La lib lo maneja con
+`categoriasSilenciadasPropose`.
+
+## Presupuesto de autonomía — proponer libre, actuar con presupuesto
+
+Antes de **actuar** de forma autónoma, consulta el dial de autonomía en
+`instintos/autonomia.yaml` (defaults = `reglas/seguridad-agentes.md`; este
+fragmento NO relaja ningún control). Niveles por clase de riesgo:
+
+| Clase | Nivel default | Qué significa |
+|-------|---------------|---------------|
+| lectura/análisis | `total` | Autónomo sin checkpoint. |
+| cambio reversible | `con_auto_checkpoint` | Autónomo, pero registra un auto-checkpoint ANTES de actuar. |
+| migración / auth / push / publish | `hitl` | Confirmación humana siempre. |
+
+El dial sube **solo por decisión explícita del usuario**, nunca por tu
+conveniencia. Un valor desconocido en el dial degrada a `hitl`.
+
+### Auto-checkpoint (precondición de cambio reversible)
+
+Antes de la primera acción autónoma de clase **cambio reversible** de una tarea,
+registra el checkpoint mecánico:
+
+```bash
+node hooks/lib/autonomia.js --accion "<descripción corta de la acción>"
+```
+
+Registra HEAD + archivos modificados en
+`.planning/user-profile/auto-checkpoints.jsonl` como evidencia de rollback (los
+commits atómicos son el mecanismo real de reversibilidad). Es best-effort: no
+bloquea la acción que protege.
+
+### Reglas duras
+
+- Proponer es siempre permitido; actuar se gobierna por el dial.
+- Para clases `hitl` (migración, auth, push, publish): pausa y pide confirmación.
+- Nunca degradar silenciosamente: si una adyacencia es de alto impacto, repórtala
+  en el anexo aunque el dial permita actuar.

package/agentes/implementador-swl.md

@@ -44,6 +44,8 @@ exclusiones:
   - "No invocar para backend Node.js puro — usar backend-node-swl para mayor profundidad en NestJS, Prisma y ecosistema Node."
   - "No invocar sin PLAN.md aprobado para features complejas — primero pasar por planificador-swl."
   - "No invocar para decisiones de arquitectura — esas decisiones corresponden a arquitecto-swl; este agente ejecuta planes, no los diseña."
+fragmentos:
+  - _propose-step
 ---
 ## Cuándo NO invocarme
 

package/agentes/orquestador-swl.md

@@ -40,6 +40,8 @@ exclusiones:
   - "No invocar para tareas de un solo agente o preguntas técnicas puntuales: el usuario puede invocar el agente especializado directamente sin pasar por el orquestador."
   - "No invocar para tomar decisiones de arquitectura — esas decisiones corresponden a arquitecto-swl; el orquestador solo coordina, no decide."
   - "No invocar cuando ya existe un PLAN.md aprobado y en ejecución activa: en ese caso invocar directamente a implementador-swl con el plan existente."
+fragmentos:
+  - _propose-step
 ---
 Eres el orquestador central del sistema SWL.
 

package/agentes/perfilador-usuario-swl.md

@@ -17,7 +17,7 @@ modeloAlterno: claude-opus-4-7
 ventanaContexto: 200k
 permissionMode: acceptEdits
 color: indigo
-version: 1.0.0
+version: 1.1.0
 nivelRiesgo: MEDIO
 skillsInvocables: [perfil-usuario, aprendizaje-continuo, memoria-busqueda, privacy-memoria]
 permisosRed: false
@@ -109,10 +109,23 @@ tercero (perfil del usuario). **No cruces los carriles:**
 | Sesiones con commits aceptados | 0.6 | Trabajo validado implícitamente |
 | Sesiones con correcciones frecuentes | 0.4 | Señal de fricción, no de preferencia firme |
 | `instintos/proyecto.yaml` con evidence_count ≥3 | 0.7 | Patrón observado en proyecto |
+| `.planning/user-profile/briefing-telemetria.json` categoría `silenciada:true` | 0.6 | El usuario ignora consistentemente esa categoría de señal proactiva |
 
 **Nunca** uses tool outputs crudos ni logs de errores como evidencia directa
 de preferencia — el ruido es alto.
 
+### Telemetría de aceptación del briefing (Fase 12, ADR-0036)
+
+El hook `session-briefing.js` mantiene `.planning/user-profile/briefing-telemetria.json`
+con, por categoría de señal (`adr-vencido`, `deuda-trigger`, `nudges-pendientes`,
+`gate-calibracion`, `continue-here`), los contadores `{mostrado, actuado, ignorado,
+silenciada}`. Al consolidar el perfil, leer este archivo como señal de **preferencias
+de proactividad**: una categoría con `silenciada:true` (ratio ignorado/mostrado ≥0.8
+con ≥5 muestras) indica que el usuario no quiere ese tipo de aviso — registrarlo en
+el perfil como preferencia de comunicación, no como anti-patrón técnico (canal A de
+`memoria-consolidada.md`, no APRENDIZAJES). NO inferir más de lo que los contadores
+dicen: actuado≠preferencia positiva fuerte, solo "resolvió la señal".
+
 ## Estructura del perfil (`instintos/perfil-usuario.yaml`)
 
 ```yaml

package/bin/swl-ses.js

@@ -119,6 +119,26 @@ const COMANDOS = {
   'audit-coverage-frameworks': '../scripts/cli/audit-coverage-frameworks.js',
   'audit-agents-gaps': '../scripts/cli/audit-agents-gaps.js',
   'skill-discovery': '../scripts/cli/skill-discovery.js',
+  'aprobar-plan': '../scripts/cli/aprobar-plan.js',
+  'verificar-plan': '../scripts/cli/verificar-plan.js',
+  'verificar-trazabilidad': '../scripts/cli/verificar-trazabilidad.js',
+  'liberar-fase': '../scripts/cli/liberar-fase.js',
+  'propose-step': '../scripts/cli/propose-step.js',
+  'derivar-feature-list': '../scripts/cli/derivar-feature-list.js',
+  'detectar-host': '../scripts/cli/detectar-host.js',
+  'metricas-dora': '../scripts/cli/metricas-dora.js',
+  'mark-evolved': '../scripts/cli/mark-evolved.js',
+  'near-duplicate': '../scripts/cli/near-duplicate.js',
+  'sugerir-modelo': '../scripts/cli/sugerir-modelo.js',
+  briefing: '../scripts/cli/briefing.js',
+  'execution-state': '../scripts/cli/execution-state.js',
+  'schedule-parse': '../scripts/cli/schedule-parse.js',
+  'gateway-notify': '../scripts/cli/gateway-notify.js',
+  'diary-entry': '../scripts/cli/diary-entry.js',
+  'loop-telemetry': '../scripts/cli/loop-telemetry.js',
+  'configurar-ci': '../scripts/cli/configurar-ci.js',
+  'ciclo-evolucion': '../scripts/cli/ciclo-evolucion.js',
+  notificaciones: '../scripts/cli/notificaciones.js',
 };
 
 // Comandos con subcomandos (nivel 2)
@@ -177,6 +197,49 @@ COMANDOS PRINCIPALES:
                                 Usado por /swl:salud.
   skill-discovery [query]       Descubre y busca skills SWL. Sin query lista todos.
                                 Flag: --rebuild. Usado por /swl:skill-search.
+  aprobar-plan --fase=N         Gate G1: firma el PLAN (SHA256 → lock) y escribe
+                                fase-activa.json (gate G0). Flags: --plan=<ruta>,
+                                --aprobado-por="texto". Usado por /swl:aprobar-plan.
+  verificar-plan --fase=N       Verifica el lock de un PLAN (read-only). Exit 1 si
+                                mutado/sin-firmar. Usado por /swl:ejecutar-fase.
+  verificar-trazabilidad --fase=N  Valida matriz REQ×T→commit→test. Flags:
+                                --solo-plan, --json. Usado por /swl:aprobar-plan.
+  liberar-fase                  Cierra el gate G0 (borra fase-activa.json). Usado
+                                por /swl:ejecutar-fase al terminar.
+  propose-step --rango=A..B     Anexo propositivo del RESUMEN de fase (ADR-0037).
+                                Opt-out SWL_PROPOSE=0. Usado por /swl:ejecutar-fase.
+  derivar-feature-list          Genera .planning/feature-list.json desde HOJA-RUTA.md.
+                                Flag: --check (exit 2 si drift). Usado por /swl:status, briefing.
+  detectar-host                 Indica si el CWD es el repo host de SWL o consumidor.
+                                Flag: --json. Usado por /swl:status.
+  metricas-dora                 Calcula métricas DORA del repo. Flags: --json, --dias=N.
+                                Usado por /swl:status.
+  mark-evolved <ruta>           Marca un componente como evolucionado (frontmatter).
+                                Flags: --from, --by, --note, --rounds, --score.
+                                Usado por /swl:aprender, autoresearch, evolucionar.
+  near-duplicate --texto="..."  Detecta si un aprendizaje es duplicado cercano.
+                                Flags: --archivo, --threshold. Usado por /swl:aprender.
+  sugerir-modelo "<tarea>"      Sugiere modelo (opus/sonnet/haiku) por complejidad.
+                                Usado por /swl:modelo.
+  briefing                      Recolecta señales baratas del briefing. Usado por
+                                /swl:briefing.
+  execution-state               Imprime el resumen de .planning/execution-state.json.
+                                Usado por /swl:checkpoint.
+  schedule-parse "<frase>"      Parsea frase en inglés a expresión cron. Usado por
+                                /swl:cron.
+  gateway-notify --texto="..."  Encola notificación al canal origen del gateway.
+                                Flags: --tipo, --to, --reply-to. Usado por /swl:inbox.
+  diary-entry  (JSON stdin)     Construye y persiste una entrada de diario de sesión.
+                                Usado por /swl:aprender.
+  loop-telemetry <op>           Telemetría de loops: iniciar|registrar|handoff|listar.
+                                Usado por /swl:verificar, autoresearch, status.
+  configurar-ci <op>            Workflows CI/CD: init|status|uninstall (salida JSON).
+                                Usado por /swl:configurar-ci.
+  ciclo-evolucion               Regenera .planning/evolution/metricas.json.
+                                Usado por /swl:status.
+  notificaciones <op>           Telegram: init|status|disable|repair|bot-start|
+                                bot-stop|bot-status|bot-restart|bot-enable-autostart|
+                                bot-disable-autostart. Usado por /swl:notificaciones.
   info    [--target <runtime>]  Muestra información del sistema instalado
   help                          Muestra esta ayuda (alias de --help)
   list    [--target <runtime>]  Lista todos los agentes y skills instalados
@@ -192,7 +255,7 @@ GESTIÓN DE COMPONENTES:
 OPCIONES DE INSTALL:
   --target <runtime>     Runtime destino: claude|openclaude|copilot|opencode|codex|gemini|cursor (default: claude)
   --profile <perfil>     Perfil: core|backend-python|backend-node|frontend-react|frontend-angular|
-                         fullstack-python-angular|fullstack-node-react|mobile|devops|completo (default: core)
+                         fullstack-python-angular|fullstack-node-react|mobile|devops|completo (default: completo)
   --with <componentes>   Incluir componentes adicionales (separados por coma)
   --without <comps>      Excluir componentes (separados por coma)
   --global               Instalar en directorio global del runtime (~/.claude, etc.)