@saulwade/swl-ses 2.6.1 → 2.8.0

package/manifiestos/hooks-config.json

@@ -1,469 +1,469 @@
-{
-  "descripcion": "Configuración centralizada de hooks SWL. Define el evento, matcher y metadata de cada hook para registro automático en settings.json del runtime destino.",
-  "prioridad_hooks": {
-    "descripcion": "Orden de precedencia cuando múltiples hooks coinciden. Mayor prioridad gana.",
-    "orden": [
-      "settings.local.json (proyecto, no versionado — máxima prioridad)",
-      "settings.json (proyecto, versionado — hooks SWL se registran aquí)",
-      "~/.claude/settings.json (global del usuario — menor prioridad)"
-    ],
-    "regla": "Los hooks SWL SOLO se registran a nivel proyecto. Si existen a nivel global, el doctor los elimina para evitar ejecución duplicada."
-  },
-  "opciones_avanzadas_hooks": {
-    "descripcion": "Campos opcionales soportados por Claude Code en cada hook entry.",
-    "timeout": "Tiempo máximo en segundos antes de abortar el hook (default: 60)",
-    "async": "Si true, el hook no bloquea la ejecución — corre en background (default: false)",
-    "once": "Si true, el hook se ejecuta solo una vez por sesión (default: false)"
-  },
-  "riskThresholds": {
-    "allow": 0.35,
-    "review": 0.6,
-    "confirm": 0.85
-  },
-  "costBudget": {
-    "maxUsd": 10.0,
-    "maxTokens": 500000,
-    "alertAt": 0.8
-  },
-  "circuitBreaker": {
-    "maxConsecutiveFailures": 3,
-    "halfOpenCooldownMs": 300000,
-    "auditThreshold": 10
-  },
-  "hooks": {
-    "escaneo-secretos.js": {
-      "event": "PreToolUse",
-      "matcher": "Write|Edit",
-      "description": "Bloquea escritura de archivos con secretos hardcodeados",
-      "blocking": true,
-      "maxConsecutiveFailures": 3,
-      "degradeOnFailure": "block"
-    },
-    "proteccion-rutas.js": {
-      "event": "PreToolUse",
-      "matcher": "Write|Edit",
-      "description": "Previene path traversal y escritura fuera del proyecto",
-      "blocking": true,
-      "maxConsecutiveFailures": 3,
-      "degradeOnFailure": "block"
-    },
-    "calidad-pre-commit.js": {
-      "event": "PreToolUse",
-      "matcher": "Bash",
-      "description": "Gate de calidad pre-commit (debug stmts, type hints, TODOs)",
-      "blocking": true,
-      "maxConsecutiveFailures": 3,
-      "degradeOnFailure": "warn"
-    },
-    "extraccion-aprendizajes.js": {
-      "event": "PostToolUse",
-      "matcher": "Bash|Write|Edit",
-      "description": "Captura aprendizajes automaticamente de la actividad de la sesion",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 3,
-      "degradeOnFailure": "skip"
-    },
-    "validar-memoria-hook.js": {
-      "event": "PostToolUse",
-      "matcher": "Write|Edit|MultiEdit",
-      "description": "Ejecuta scripts/validar-memoria.js cuando se modifica APRENDIZAJES.md, perfil-usuario.yaml o instintos/{proyecto,global}.yaml. Emite nudge si detecta canal incorrecto, duplicación cross-canal, secretos o PII. Opt-out con SWL_VALIDAR_MEMORIA=0.",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 3,
-      "degradeOnFailure": "skip"
-    },
-    "sugerir-regenerar-inventario.js": {
-      "event": "PostToolUse",
-      "matcher": "Write|Edit|MultiEdit",
-      "description": "Sugiere regenerar INVENTARIO.md cuando el agente toca agentes/, habilidades/, comandos/swl/, hooks/ o reglas/. Cooldown 30 min para evitar spam.",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "sugerir-contribuir.js": {
-      "event": "PostToolUse",
-      "matcher": "Write|Edit|MultiEdit",
-      "description": "Cuando el usuario edita un componente con frontmatter `evolved: true` en su instalación (no en el repo fuente), sugiere abrir /swl:contribuir para subir la mejora al core. Cooldown 24h por archivo. Activo por defecto; silenciar con SWL_SUGERIR_CONTRIBUIR=0.",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "degradacion-instintos.js": {
-      "event": "PostToolUse",
-      "matcher": "Bash|Write|Edit",
-      "description": "Degrada instintos contradichos por evidencia negativa en la sesion",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 3,
-      "degradeOnFailure": "skip"
-    },
-    "risk-scoring.js": {
-      "event": "PreToolUse",
-      "matcher": "",
-      "description": "Scoring de riesgo compuesto para operaciones — bloquea operaciones peligrosas",
-      "blocking": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "warn"
-    },
-    "tracking-costos.js": {
-      "event": "PostToolUse",
-      "matcher": "",
-      "description": "Registra tokens estimados y costo por sesion en .planning/METRICAS.md",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "inyeccion-contexto.js": {
-      "event": "PostToolUse",
-      "matcher": "",
-      "description": "Inyecta contexto de sesion anterior automaticamente al inicio de nueva sesion",
-      "blocking": false,
-      "maxConsecutiveFailures": 3,
-      "degradeOnFailure": "skip"
-    },
-    "auto-consolidacion.js": {
-      "event": "PostToolUse",
-      "matcher": "",
-      "description": "Sugiere /swl:aprender cuando hay >= 24h y >= 5 sesiones nuevas sin consolidar (patrón autoDream)",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 3,
-      "degradeOnFailure": "skip"
-    },
-    "auto-background.js": {
-      "event": "PreToolUse",
-      "matcher": "Bash",
-      "description": "Sugiere run_in_background para comandos lentos (npm install, cargo build, docker build, etc.)",
-      "blocking": false,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "resumen-sesion.js": {
-      "event": "Stop",
-      "matcher": "",
-      "description": "Imprime resumen de sesión SWL al terminar: agentes, skills, comandos, tokens y costo",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "ciclo-evolucion.js": {
-      "event": "Stop",
-      "matcher": "",
-      "description": "Ciclo de evolución (evento Stop): en un solo proceso ejecuta las sub-etapas de métricas (consolida .planning/evolution/metricas.json con health_score; escala alertas persistentes si >=5 nudges del mismo tipo ignorados en 14d) y perfil de usuario (acumula dirty-bit en .planning/user-profile/; nudge a perfilador-usuario-swl al cruzar umbral). Fusión de metricas-evolucion.js + actualizar-perfil-usuario.js (Fase 11, D-12). Lógica en hooks/lib/etapa-{metricas,perfil-usuario}.js.",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "rotar-audit-auto.js": {
-      "event": "Stop",
-      "matcher": "",
-      "description": "Rotación automática de logs de auditoría (.planning/audit.jsonl y audit-merkle.jsonl) cuando superan 5 MB. Invoca scripts/rotar-audit-logs.js con retención de 30 días, comprime a .gz mensual y preserva cadena Merkle. Desactivable con SWL_AUDIT_ROTATE_OFF=1. Configurable con SWL_AUDIT_ROTATE_UMBRAL_MB y SWL_AUDIT_ROTATE_DIAS. Cooldown de 6 horas para evitar ejecución repetida.",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "ciclo-evolucion-subagente.js": {
-      "event": "SubagentStop",
-      "matcher": "",
-      "description": "Ciclo de evolución (evento SubagentStop): registra cada terminación de subagente SWL en .planning/auto-evolution/agentes.jsonl y emite nudge a /swl:evolucionar cuando un agente acumula fallos, volumen de runs, loop o drift (ventana 14 días, throttle 24h). Renombrado de auto-evolucion.js (Fase 11, D-12). Lógica en hooks/lib/etapa-auto-evolucion.js.",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "validar-formato-post-subagente.js": {
-      "event": "SubagentStop",
-      "matcher": "",
-      "description": "Valida output de subagentes con schema declarado en manifiestos/agent-output-schemas.json (revisor-* y tdd-qa). Registra violaciones en .planning/evolution/formato-violaciones.jsonl. Opt-out: SWL_FORMATO_VALIDACION=0.",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 3,
-      "degradeOnFailure": "skip"
-    },
-    "telemetria-agentes.js": {
-      "event": "PostToolUse",
-      "matcher": "Agent",
-      "description": "Registra traza OTLP-lite por cada invocación de agente SWL en .planning/traces/",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "telemetria-skill-routing.js": {
-      "event": "PostToolUse",
-      "matcher": "Skill",
-      "description": "Registra frecuencia/estado de cada invocación de skill en .planning/skill-metrics.json (alimenta auditoría de bloat, P-2). Opt-out SWL_SKILL_TELEMETRIA=0",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "audit-trail.js": {
-      "event": "PostToolUse",
-      "matcher": "",
-      "description": "Registra cada tool call en .planning/audit.jsonl para auditoría y cumplimiento",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "registro-turnos.js": {
-      "event": "PostToolUse",
-      "matcher": "",
-      "description": "Persiste cada turn en .planning/sessions/{id}/turns.jsonl con sanitización PII (OPT-IN: SWL_REGISTRO_TURNOS=1)",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "agente-lifecycle.js": {
-      "event": "SubagentStop",
-      "matcher": "",
-      "description": "Emite eventos de ciclo de vida al event-bus y actualiza execution-state al finalizar cada agente SWL",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "grafo-contexto.js": {
-      "event": "PreToolUse",
-      "matcher": "Glob|Grep|Read",
-      "description": "Inyecta resumen del grafo de dependencias SWL antes de búsquedas de archivos — reduce tool calls ~71x. Opt-in: silencioso si .planning/graph.json no existe.",
-      "blocking": false,
-      "async": false,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "calidad-typescript.js": {
-      "event": "PreToolUse",
-      "matcher": "Bash",
-      "description": "Verifica calidad TypeScript en archivos staged antes de git commit: any explícito, @ts-ignore sin justificación, double cast, tsc --noEmit",
-      "blocking": true,
-      "maxConsecutiveFailures": 3,
-      "degradeOnFailure": "warn"
-    },
-    "clasificador-mensajes.js": {
-      "event": "UserPromptSubmit",
-      "matcher": "",
-      "description": "Clasifica intención del mensaje del usuario e inyecta hints de routing para el orquestador (decisión, bug, requisito, arquitectura, etc.)",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "graph-update.js": {
-      "event": "PostToolUse",
-      "matcher": "Write|Edit",
-      "description": "Actualiza el grafo de code-review-graph automáticamente después de cada modificación de archivo",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "preservar-estado-pre-compact.js": {
-      "event": "PreCompact",
-      "matcher": "",
-      "description": "Preserva execution-state.json y task-queue.json antes de compactación de contexto para asegurar continuidad del plan",
-      "blocking": false,
-      "maxConsecutiveFailures": 3,
-      "degradeOnFailure": "skip"
-    },
-    "check-update.js": {
-      "event": "UserPromptSubmit",
-      "matcher": "",
-      "description": "Detecta actualizaciones disponibles de swl-ses comparando versión local vs npm registry (throttled 24h)",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "contexto-iteracion.js": {
-      "event": "UserPromptSubmit",
-      "matcher": "",
-      "description": "Anti-context-rot para loops iterativos: inyecta el estado de la corrida activa en .planning/loops/ (iteración, últimas filas del TSV, plateau/recomendación de trayectoria). Throttled a 1 inyección cada 4 min por corrida. Opt-out: SWL_CONTEXTO_ITERACION=0.",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "contexto-subagente.js": {
-      "event": "SubagentStart",
-      "matcher": "",
-      "description": "Re-inyecta a cada subagente las disciplinas transversales de la sesión (idioma es-MX, escalera de código mínimo con guardas, marcador simplificado:) — el contexto de SessionStart nunca llega a subagentes. Opt-out: SWL_CONTEXTO_SUBAGENTE=0.",
-      "blocking": false,
-      "async": false,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "guardrail-modelo.js": {
-      "event": "PreToolUse",
-      "matcher": "Task|Agent",
-      "description": "Guardrail semántico observacional: registra subagentes que podrían ejecutarse con un modelo menos costoso. Opt-in: SWL_GUARDRAIL_MODELO=1. Modo observacional — nunca bloquea.",
-      "blocking": false,
-      "async": false,
-      "optIn": "SWL_GUARDRAIL_MODELO",
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "notificacion-sesion-stop.js": {
-      "event": "Stop",
-      "matcher": "",
-      "description": "Al terminar un turno con >=10 tool calls envía al gateway una notificación con contexto: modelo, llamadas, tokens, costo, archivos modificados y último tramo del transcript. Opt-in: requiere gateway habilitado en manifiestos/gateway-config.json. Opt-out: SWL_NOTIFICAR_STOP=0.",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "captura-feedback-usuario.js": {
-      "event": "UserPromptSubmit",
-      "matcher": "",
-      "description": "Detecta correcciones explícitas del usuario (no hagas X, prefiero Y, recuerda Z, nunca W) y las encola en .planning/evolution/feedback-queue.jsonl para consumo por perfilador-usuario-swl y el ciclo AGP. Patrones regex en español e inglés. Opt-out: SWL_CAPTURAR_FEEDBACK=0.",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "inbox-aviso.js": {
-      "event": "UserPromptSubmit",
-      "matcher": "",
-      "description": "Avisa cuando hay comandos pendientes en .planning/inbox/ enviados desde canales externos (Telegram vía gateway con relay). Inyecta additionalContext para que Claude sugiera ejecutar /swl:inbox. Opt-out: SWL_INBOX_AVISO=0.",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "aiisms-detector.js": {
-      "event": "PostToolUse",
-      "matcher": "Write|Edit|MultiEdit",
-      "description": "Ejecuta detector portable Python contra archivos .md recién modificados y emite nudge a .planning/evolution/nudges.jsonl si encuentra al menos un AI-ism P0. No bloquea. Requiere Python 3.10+. Respeta auto-referencia (habilidades/estilo-sin-ai-isms/), .planning/, temp/, node_modules/. Opt-out: SWL_AIISMS_HOOK=0.",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "claudemd-bloat-detector.js": {
-      "event": "PostToolUse",
-      "matcher": "Write|Edit|MultiEdit",
-      "description": "Ejecuta scripts/auditar-claudemd.js contra archivos CLAUDE.md recién modificados (basename exacto, no cualquier .md). Emite nudge a .planning/evolution/nudges.jsonl si veredicto != OK (líneas excesivas, bullets gigantes, secciones canónicas ausentes, sin @references, placeholders). Aplica ADR-0016 (best practices Anthropic 'The CLAUDE.md file'). No bloquea. Excluye temp/, node_modules/, respositorios-git/, .planning/. Opt-out: SWL_CLAUDEMD_BLOAT=0.",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "claudemd-duplicacion-detector.js": {
-      "event": "PostToolUse",
-      "matcher": "Write|Edit|MultiEdit",
-      "description": "Detecta duplicación de reglas globales (~/.claude/rules/) inline en CLAUDE.md de proyecto. Consume scripts/lib/detector-reglas-duplicadas.js + catálogo scripts/lib/reglas-globales-conocidas.json. Aplica regla reglas/sin-duplicacion-reglas-globales.md. Emite nudge a .planning/evolution/nudges.jsonl si hay duplicaciones detectadas. No bloquea — kind: claudemd-duplicacion-reglas. Excluye temp/, node_modules/, respositorios-git/, .planning/, ~/.claude/ (user-level). Opt-out: SWL_CLAUDEMD_DUPLICACION=0.",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "tdd-gate.js": {
-      "event": "PreToolUse",
-      "matcher": "Bash",
-      "description": "Gate G2 (TDD): ante git commit de feature (fuente+tests staged) verifica evidencia de ciclo RED en .planning/loops/tdd-* (telemetria escrita por ejecutar-fase/tdd-workflow). Sin evidencia emite nudge kind:tdd-red-evidence (warn-only, NUNCA exit 2 en este modo). Solo aplica con fase activa (ciclo GSD); 'fuente sin tests' es dominio de G3 (sin doble nudge). Respeta opt-out declarado del CONTEXTO (**TDD**: off) y prefijos docs:/chore:/style:. Ventana de evidencia: 24h (SWL_TDD_GATE_VENTANA_H). Opt-out: SWL_TDD_GATE=0. Promocion a blocking via ADR-0035 (D-07).",
-      "blocking": false,
-      "async": false,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "warn"
-    },
-    "spec-gate.js": {
-      "event": "PreToolUse",
-      "matcher": "Write|Edit|MultiEdit",
-      "description": "Gate G0 (SDD): detecta Write/Edit a codigo fuente sin fase activa con PLAN aprobado. Lee .planning/locks/fase-activa.json (escrito por /swl:aprobar-plan) y re-computa SHA256 del plan referenciado; sin fase activa o plan mutado emite nudge kind:spec-gate (warn-only, NUNCA exit 2 en este modo). Zero-config: sin .planning/ sale silencioso. Excluye tests/generados/docs (clasificador esArchivoFuente de calidad-pre-commit) y temp/, node_modules/, _userland/, respositorios-git/. Opt-out: SWL_SPEC_GATE=0. Promocion a blocking via ADR-0034 tras ~2 semanas de calibracion (D-07).",
-      "blocking": false,
-      "async": false,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "warn"
-    },
-    "validar-intent-spec.js": {
-      "event": "PostToolUse",
-      "matcher": "Write|Edit|MultiEdit",
-      "description": "Verifica que agentes nivelRiesgo:ALTO declaren las 6 partes del framework Intent Engineering (strategy, healthMetrics, steering, hardGuardrails, maxTurnos, fragmentos:[_intent-spec]) segun reglas/intent-engineering.md. Solo aplica a agentes/*.md no fragmentos. Emite nudge a .planning/evolution/nudges.jsonl y BLOQUEA (exit 2) si faltan campos. Excluye temp/, node_modules/, respositorios-git/, _userland/, .planning/. Opt-out: SWL_INTENT_SPEC=0. ADR-0027 (warn-only) -> ADR-0033 (blocking, 2026-06-11).",
-      "blocking": true,
-      "async": false,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "warn"
-    },
-    "notificacion-telegram.js": {
-      "event": "Stop",
-      "matcher": "",
-      "description": "Envía notificación Telegram al terminar un turno. Muestra último mensaje del asistente, proyecto y estado. Best-effort: siempre exit 0. Requiere ~/.claude/notifications/.env con TELEGRAM_BOT_TOKEN y TELEGRAM_CHAT_ID. Opt-out: SWL_NOTIFICACIONES_TELEGRAM=0.",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "notificacion-telegram-notification.js": {
-      "event": "Notification",
-      "matcher": "",
-      "description": "Envía notificación Telegram cuando Claude espera respuesta del usuario (permisos, idle, atención requerida). Best-effort: siempre exit 0. Comparte implementación con notificacion-telegram.js. Opt-out: SWL_NOTIFICACIONES_TELEGRAM=0.",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "notificacion-telegram-subagent.js": {
-      "event": "SubagentStop",
-      "matcher": "",
-      "description": "Envía notificación Telegram cuando un subagente termina su turno. INERTE por default: SubagentStop no está en los eventos default del script compartido porque duplica la notificación del Stop final (mismo cuerpo, dos mensajes). Activar con CLAUDE_NOTIFY_EVENTS=Stop,Notification,SubagentStop. Best-effort: siempre exit 0. Opt-out global: SWL_NOTIFICACIONES_TELEGRAM=0.",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "auto-restaurar-settings.js": {
-      "event": "SessionStart",
-      "matcher": "",
-      "description": "Al inicio de cada sesión verifica que ~/.claude/settings.json contiene los hooks SWL registrados en ~/.claude/notifications/baseline-hooks.json. Si falta alguno, los restaura preservando todos los hooks ajenos al baseline. Backup obligatorio antes de cada modificación. Opt-out: SWL_NOTIFICACIONES_TELEGRAM=0.",
-      "blocking": false,
-      "async": false,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "session-briefing.js": {
-      "event": "SessionStart",
-      "matcher": "",
-      "description": "Briefing proactivo de inicio de sesión (Fase 12, ADR-0036): digest no solicitado de señales accionables del proyecto destino — ADRs Propuestos con reevaluación vencida, deuda con trigger por fecha cumplido, nudges sin accionar, gates en calibración con ventana cumplida, y trabajo de retoma pendiente. Máximo 5 ítems con acción ejecutable; silencio total sin señales nuevas; dedupe diario. Solo filesystem, presupuesto <200ms. Opt-out: SWL_BRIEFING=0.",
-      "blocking": false,
-      "async": false,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "captura-acciones-post.js": {
-      "event": "PostToolUse",
-      "matcher": "",
-      "description": "Captura señales de ACCIÓN del usuario (Fase 17): registra SHAs de commits del agente y hashes de escrituras (Write/Edit/MultiEdit), y detecta edición manual en caliente al re-leer un archivo modificado fuera de sesión. Encola en feedback-queue.jsonl con tipo:\"accion\" (esquema extendido backward-compatible). Sanitización PII obligatoria de evidencia. Opt-out: SWL_CAPTURAR_FEEDBACK=0.",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "captura-acciones-session.js": {
-      "event": "SessionStart",
-      "matcher": "",
-      "description": "Detecta señales de ACCIÓN del usuario ocurridas fuera de sesión (Fase 17): revert/reset de commits del agente, edición neta de archivos escritos por el agente, rechazo de plan y override de veredicto. Encola en feedback-queue.jsonl con tipo:\"accion\"; NO muestra al modelo (solo persiste). Skip si no hay repo git; presupuesto p95<400ms. Opt-out: SWL_CAPTURAR_FEEDBACK=0.",
-      "blocking": false,
-      "async": false,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    },
-    "validar-planning-paths.js": {
-      "event": "PostToolUse",
-      "matcher": "Write|Edit|MultiEdit",
-      "description": "Advierte cuando una sesion crea un directorio top-level NUEVO en .planning/ fuera de la allowlist canonica (manifiestos/planning-paths.json). Atrapa divergencias es/en (auditoria/ vs audit/, ux/ vs design/) antes de que proliferen. Aplica reglas/analizar-directorios-antes-de-escribir.md, cierra DT-PLANNING-OUTPUT-PATHS (ADR-0031). Emite nudge kind: planning-path-divergente a .planning/evolution/nudges.jsonl. No bloquea (warn-only). Opt-out: SWL_PLANNING_PATHS=0.",
-      "blocking": false,
-      "async": true,
-      "maxConsecutiveFailures": 5,
-      "degradeOnFailure": "skip"
-    }
-  }
-}
+{
+  "descripcion": "Configuración centralizada de hooks SWL. Define el evento, matcher y metadata de cada hook para registro automático en settings.json del runtime destino.",
+  "prioridad_hooks": {
+    "descripcion": "Orden de precedencia cuando múltiples hooks coinciden. Mayor prioridad gana.",
+    "orden": [
+      "settings.local.json (proyecto, no versionado — máxima prioridad)",
+      "settings.json (proyecto, versionado — hooks SWL se registran aquí)",
+      "~/.claude/settings.json (global del usuario — menor prioridad)"
+    ],
+    "regla": "Los hooks SWL SOLO se registran a nivel proyecto. Si existen a nivel global, el doctor los elimina para evitar ejecución duplicada."
+  },
+  "opciones_avanzadas_hooks": {
+    "descripcion": "Campos opcionales soportados por Claude Code en cada hook entry.",
+    "timeout": "Tiempo máximo en segundos antes de abortar el hook (default: 60)",
+    "async": "Si true, el hook no bloquea la ejecución — corre en background (default: false)",
+    "once": "Si true, el hook se ejecuta solo una vez por sesión (default: false)"
+  },
+  "riskThresholds": {
+    "allow": 0.35,
+    "review": 0.6,
+    "confirm": 0.85
+  },
+  "costBudget": {
+    "maxUsd": 10.0,
+    "maxTokens": 500000,
+    "alertAt": 0.8
+  },
+  "circuitBreaker": {
+    "maxConsecutiveFailures": 3,
+    "halfOpenCooldownMs": 300000,
+    "auditThreshold": 10
+  },
+  "hooks": {
+    "escaneo-secretos.js": {
+      "event": "PreToolUse",
+      "matcher": "Write|Edit",
+      "description": "Bloquea escritura de archivos con secretos hardcodeados",
+      "blocking": true,
+      "maxConsecutiveFailures": 3,
+      "degradeOnFailure": "block"
+    },
+    "proteccion-rutas.js": {
+      "event": "PreToolUse",
+      "matcher": "Write|Edit",
+      "description": "Previene path traversal y escritura fuera del proyecto",
+      "blocking": true,
+      "maxConsecutiveFailures": 3,
+      "degradeOnFailure": "block"
+    },
+    "calidad-pre-commit.js": {
+      "event": "PreToolUse",
+      "matcher": "Bash",
+      "description": "Gate de calidad pre-commit (debug stmts, type hints, TODOs)",
+      "blocking": true,
+      "maxConsecutiveFailures": 3,
+      "degradeOnFailure": "warn"
+    },
+    "extraccion-aprendizajes.js": {
+      "event": "PostToolUse",
+      "matcher": "Bash|Write|Edit",
+      "description": "Captura aprendizajes automaticamente de la actividad de la sesion",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 3,
+      "degradeOnFailure": "skip"
+    },
+    "validar-memoria-hook.js": {
+      "event": "PostToolUse",
+      "matcher": "Write|Edit|MultiEdit",
+      "description": "Ejecuta scripts/validar-memoria.js cuando se modifica APRENDIZAJES.md, perfil-usuario.yaml o instintos/{proyecto,global}.yaml. Emite nudge si detecta canal incorrecto, duplicación cross-canal, secretos o PII. Opt-out con SWL_VALIDAR_MEMORIA=0.",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 3,
+      "degradeOnFailure": "skip"
+    },
+    "sugerir-regenerar-inventario.js": {
+      "event": "PostToolUse",
+      "matcher": "Write|Edit|MultiEdit",
+      "description": "Sugiere regenerar INVENTARIO.md cuando el agente toca agentes/, habilidades/, comandos/swl/, hooks/ o reglas/. Cooldown 30 min para evitar spam.",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "sugerir-contribuir.js": {
+      "event": "PostToolUse",
+      "matcher": "Write|Edit|MultiEdit",
+      "description": "Cuando el usuario edita un componente con frontmatter `evolved: true` en su instalación (no en el repo fuente), sugiere abrir /swl:contribuir para subir la mejora al core. Cooldown 24h por archivo. Activo por defecto; silenciar con SWL_SUGERIR_CONTRIBUIR=0.",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "degradacion-instintos.js": {
+      "event": "PostToolUse",
+      "matcher": "Bash|Write|Edit",
+      "description": "Degrada instintos contradichos por evidencia negativa en la sesion",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 3,
+      "degradeOnFailure": "skip"
+    },
+    "risk-scoring.js": {
+      "event": "PreToolUse",
+      "matcher": "",
+      "description": "Scoring de riesgo compuesto para operaciones — bloquea operaciones peligrosas",
+      "blocking": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "warn"
+    },
+    "tracking-costos.js": {
+      "event": "PostToolUse",
+      "matcher": "",
+      "description": "Registra tokens estimados y costo por sesion en .planning/METRICAS.md",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "inyeccion-contexto.js": {
+      "event": "PostToolUse",
+      "matcher": "",
+      "description": "Inyecta contexto de sesion anterior automaticamente al inicio de nueva sesion",
+      "blocking": false,
+      "maxConsecutiveFailures": 3,
+      "degradeOnFailure": "skip"
+    },
+    "auto-consolidacion.js": {
+      "event": "PostToolUse",
+      "matcher": "",
+      "description": "Sugiere /swl:aprender cuando hay >= 24h y >= 5 sesiones nuevas sin consolidar (patrón autoDream)",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 3,
+      "degradeOnFailure": "skip"
+    },
+    "auto-background.js": {
+      "event": "PreToolUse",
+      "matcher": "Bash",
+      "description": "Sugiere run_in_background para comandos lentos (npm install, cargo build, docker build, etc.)",
+      "blocking": false,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "resumen-sesion.js": {
+      "event": "Stop",
+      "matcher": "",
+      "description": "Imprime resumen de sesión SWL al terminar: agentes, skills, comandos, tokens y costo",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "ciclo-evolucion.js": {
+      "event": "Stop",
+      "matcher": "",
+      "description": "Ciclo de evolución (evento Stop): en un solo proceso ejecuta las sub-etapas de métricas (consolida .planning/evolution/metricas.json con health_score; escala alertas persistentes si >=5 nudges del mismo tipo ignorados en 14d) y perfil de usuario (acumula dirty-bit en .planning/user-profile/; nudge a perfilador-usuario-swl al cruzar umbral). Fusión de metricas-evolucion.js + actualizar-perfil-usuario.js (Fase 11, D-12). Lógica en hooks/lib/etapa-{metricas,perfil-usuario}.js.",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "rotar-audit-auto.js": {
+      "event": "Stop",
+      "matcher": "",
+      "description": "Rotación automática de logs de auditoría (.planning/audit.jsonl y audit-merkle.jsonl) cuando superan 5 MB. Invoca scripts/rotar-audit-logs.js con retención de 30 días, comprime a .gz mensual y preserva cadena Merkle. Desactivable con SWL_AUDIT_ROTATE_OFF=1. Configurable con SWL_AUDIT_ROTATE_UMBRAL_MB y SWL_AUDIT_ROTATE_DIAS. Cooldown de 6 horas para evitar ejecución repetida.",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "ciclo-evolucion-subagente.js": {
+      "event": "SubagentStop",
+      "matcher": "",
+      "description": "Ciclo de evolución (evento SubagentStop): registra cada terminación de subagente SWL en .planning/auto-evolution/agentes.jsonl y emite nudge a /swl:evolucionar cuando un agente acumula fallos, volumen de runs, loop o drift (ventana 14 días, throttle 24h). Renombrado de auto-evolucion.js (Fase 11, D-12). Lógica en hooks/lib/etapa-auto-evolucion.js.",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "validar-formato-post-subagente.js": {
+      "event": "SubagentStop",
+      "matcher": "",
+      "description": "Valida output de subagentes con schema declarado en manifiestos/agent-output-schemas.json (revisor-* y tdd-qa). Registra violaciones en .planning/evolution/formato-violaciones.jsonl. Opt-out: SWL_FORMATO_VALIDACION=0.",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 3,
+      "degradeOnFailure": "skip"
+    },
+    "telemetria-agentes.js": {
+      "event": "PostToolUse",
+      "matcher": "Agent",
+      "description": "Registra traza OTLP-lite por cada invocación de agente SWL en .planning/traces/",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "telemetria-skill-routing.js": {
+      "event": "PostToolUse",
+      "matcher": "Skill",
+      "description": "Registra frecuencia/estado de cada invocación de skill en .planning/skill-metrics.json (alimenta auditoría de bloat, P-2). Opt-out SWL_SKILL_TELEMETRIA=0",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "audit-trail.js": {
+      "event": "PostToolUse",
+      "matcher": "",
+      "description": "Registra cada tool call en .planning/audit.jsonl para auditoría y cumplimiento",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "registro-turnos.js": {
+      "event": "PostToolUse",
+      "matcher": "",
+      "description": "Persiste cada turn en .planning/sessions/{id}/turns.jsonl con sanitización PII (OPT-IN: SWL_REGISTRO_TURNOS=1)",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "agente-lifecycle.js": {
+      "event": "SubagentStop",
+      "matcher": "",
+      "description": "Emite eventos de ciclo de vida al event-bus y actualiza execution-state al finalizar cada agente SWL",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "grafo-contexto.js": {
+      "event": "PreToolUse",
+      "matcher": "Glob|Grep|Read",
+      "description": "Inyecta resumen del grafo de dependencias SWL antes de búsquedas de archivos — reduce tool calls ~71x. Opt-in: silencioso si .planning/graph.json no existe.",
+      "blocking": false,
+      "async": false,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "calidad-typescript.js": {
+      "event": "PreToolUse",
+      "matcher": "Bash",
+      "description": "Verifica calidad TypeScript en archivos staged antes de git commit: any explícito, @ts-ignore sin justificación, double cast, tsc --noEmit",
+      "blocking": true,
+      "maxConsecutiveFailures": 3,
+      "degradeOnFailure": "warn"
+    },
+    "clasificador-mensajes.js": {
+      "event": "UserPromptSubmit",
+      "matcher": "",
+      "description": "Clasifica intención del mensaje del usuario e inyecta hints de routing para el orquestador (decisión, bug, requisito, arquitectura, etc.)",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "graph-update.js": {
+      "event": "PostToolUse",
+      "matcher": "Write|Edit",
+      "description": "Actualiza el grafo de code-review-graph automáticamente después de cada modificación de archivo",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "preservar-estado-pre-compact.js": {
+      "event": "PreCompact",
+      "matcher": "",
+      "description": "Preserva execution-state.json y task-queue.json antes de compactación de contexto para asegurar continuidad del plan",
+      "blocking": false,
+      "maxConsecutiveFailures": 3,
+      "degradeOnFailure": "skip"
+    },
+    "check-update.js": {
+      "event": "UserPromptSubmit",
+      "matcher": "",
+      "description": "Detecta actualizaciones disponibles de swl-ses comparando versión local vs npm registry (throttled 24h)",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "contexto-iteracion.js": {
+      "event": "UserPromptSubmit",
+      "matcher": "",
+      "description": "Anti-context-rot para loops iterativos: inyecta el estado de la corrida activa en .planning/loops/ (iteración, últimas filas del TSV, plateau/recomendación de trayectoria). Throttled a 1 inyección cada 4 min por corrida. Opt-out: SWL_CONTEXTO_ITERACION=0.",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "contexto-subagente.js": {
+      "event": "SubagentStart",
+      "matcher": "",
+      "description": "Re-inyecta a cada subagente las disciplinas transversales de la sesión (idioma es-MX, escalera de código mínimo con guardas, marcador simplificado:) — el contexto de SessionStart nunca llega a subagentes. Opt-out: SWL_CONTEXTO_SUBAGENTE=0.",
+      "blocking": false,
+      "async": false,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "guardrail-modelo.js": {
+      "event": "PreToolUse",
+      "matcher": "Task|Agent",
+      "description": "Guardrail semántico observacional: registra subagentes que podrían ejecutarse con un modelo menos costoso. Opt-in: SWL_GUARDRAIL_MODELO=1. Modo observacional — nunca bloquea.",
+      "blocking": false,
+      "async": false,
+      "optIn": "SWL_GUARDRAIL_MODELO",
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "notificacion-sesion-stop.js": {
+      "event": "Stop",
+      "matcher": "",
+      "description": "Al terminar un turno con >=10 tool calls envía al gateway una notificación con contexto: modelo, llamadas, tokens, costo, archivos modificados y último tramo del transcript. Opt-in: requiere gateway habilitado en manifiestos/gateway-config.json. Opt-out: SWL_NOTIFICAR_STOP=0.",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "captura-feedback-usuario.js": {
+      "event": "UserPromptSubmit",
+      "matcher": "",
+      "description": "Detecta correcciones explícitas del usuario (no hagas X, prefiero Y, recuerda Z, nunca W) y las encola en .planning/evolution/feedback-queue.jsonl para consumo por perfilador-usuario-swl y el ciclo AGP. Patrones regex en español e inglés. Opt-out: SWL_CAPTURAR_FEEDBACK=0.",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "inbox-aviso.js": {
+      "event": "UserPromptSubmit",
+      "matcher": "",
+      "description": "Avisa cuando hay comandos pendientes en .planning/inbox/ enviados desde canales externos (Telegram vía gateway con relay). Inyecta additionalContext para que Claude sugiera ejecutar /swl:inbox. Opt-out: SWL_INBOX_AVISO=0.",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "aiisms-detector.js": {
+      "event": "PostToolUse",
+      "matcher": "Write|Edit|MultiEdit",
+      "description": "Ejecuta detector portable Python contra archivos .md recién modificados y emite nudge a .planning/evolution/nudges.jsonl si encuentra al menos un AI-ism P0. No bloquea. Requiere Python 3.10+. Respeta auto-referencia (habilidades/estilo-sin-ai-isms/), .planning/, temp/, node_modules/. Opt-out: SWL_AIISMS_HOOK=0.",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "claudemd-bloat-detector.js": {
+      "event": "PostToolUse",
+      "matcher": "Write|Edit|MultiEdit",
+      "description": "Ejecuta scripts/auditar-claudemd.js contra archivos CLAUDE.md recién modificados (basename exacto, no cualquier .md). Emite nudge a .planning/evolution/nudges.jsonl si veredicto != OK (líneas excesivas, bullets gigantes, secciones canónicas ausentes, sin @references, placeholders). Aplica ADR-0016 (best practices Anthropic 'The CLAUDE.md file'). No bloquea. Excluye temp/, node_modules/, respositorios-git/, .planning/. Opt-out: SWL_CLAUDEMD_BLOAT=0.",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "claudemd-duplicacion-detector.js": {
+      "event": "PostToolUse",
+      "matcher": "Write|Edit|MultiEdit",
+      "description": "Detecta duplicación de reglas globales (~/.claude/rules/) inline en CLAUDE.md de proyecto. Consume scripts/lib/detector-reglas-duplicadas.js + catálogo scripts/lib/reglas-globales-conocidas.json. Aplica regla reglas/sin-duplicacion-reglas-globales.md. Emite nudge a .planning/evolution/nudges.jsonl si hay duplicaciones detectadas. No bloquea — kind: claudemd-duplicacion-reglas. Excluye temp/, node_modules/, respositorios-git/, .planning/, ~/.claude/ (user-level). Opt-out: SWL_CLAUDEMD_DUPLICACION=0.",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "tdd-gate.js": {
+      "event": "PreToolUse",
+      "matcher": "Bash",
+      "description": "Gate G2 (TDD): ante git commit de feature (fuente+tests staged) verifica evidencia de ciclo RED en .planning/loops/tdd-* (telemetria escrita por ejecutar-fase/tdd-workflow). Sin evidencia emite nudge kind:tdd-red-evidence (warn-only, NUNCA exit 2 en este modo). Solo aplica con fase activa (ciclo GSD); 'fuente sin tests' es dominio de G3 (sin doble nudge). Respeta opt-out declarado del CONTEXTO (**TDD**: off) y prefijos docs:/chore:/style:. Ventana de evidencia: 24h (SWL_TDD_GATE_VENTANA_H). Opt-out: SWL_TDD_GATE=0. Promocion a blocking via ADR-0035 (D-07).",
+      "blocking": false,
+      "async": false,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "warn"
+    },
+    "spec-gate.js": {
+      "event": "PreToolUse",
+      "matcher": "Write|Edit|MultiEdit",
+      "description": "Gate G0 (SDD): detecta Write/Edit a codigo fuente sin fase activa con PLAN aprobado. Lee .planning/locks/fase-activa.json (escrito por /swl:aprobar-plan) y re-computa SHA256 del plan referenciado; sin fase activa o plan mutado emite nudge kind:spec-gate (warn-only, NUNCA exit 2 en este modo). Zero-config: sin .planning/ sale silencioso. Excluye tests/generados/docs (clasificador esArchivoFuente de calidad-pre-commit) y temp/, node_modules/, _userland/, respositorios-git/. Opt-out: SWL_SPEC_GATE=0. Promocion a blocking via ADR-0034 tras ~2 semanas de calibracion (D-07).",
+      "blocking": false,
+      "async": false,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "warn"
+    },
+    "validar-intent-spec.js": {
+      "event": "PostToolUse",
+      "matcher": "Write|Edit|MultiEdit",
+      "description": "Verifica que agentes nivelRiesgo:ALTO declaren las 6 partes del framework Intent Engineering (strategy, healthMetrics, steering, hardGuardrails, maxTurnos, fragmentos:[_intent-spec]) segun reglas/intent-engineering.md. Solo aplica a agentes/*.md no fragmentos. Emite nudge a .planning/evolution/nudges.jsonl y BLOQUEA (exit 2) si faltan campos. Excluye temp/, node_modules/, respositorios-git/, _userland/, .planning/. Opt-out: SWL_INTENT_SPEC=0. ADR-0027 (warn-only) -> ADR-0033 (blocking, 2026-06-11).",
+      "blocking": true,
+      "async": false,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "warn"
+    },
+    "notificacion-telegram.js": {
+      "event": "Stop",
+      "matcher": "",
+      "description": "Envía notificación Telegram al terminar un turno. Muestra último mensaje del asistente, proyecto y estado. Best-effort: siempre exit 0. Requiere ~/.claude/notifications/.env con TELEGRAM_BOT_TOKEN y TELEGRAM_CHAT_ID. Opt-out: SWL_NOTIFICACIONES_TELEGRAM=0.",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "notificacion-telegram-notification.js": {
+      "event": "Notification",
+      "matcher": "",
+      "description": "Envía notificación Telegram cuando Claude espera respuesta del usuario (permisos, idle, atención requerida). Best-effort: siempre exit 0. Comparte implementación con notificacion-telegram.js. Opt-out: SWL_NOTIFICACIONES_TELEGRAM=0.",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "notificacion-telegram-subagent.js": {
+      "event": "SubagentStop",
+      "matcher": "",
+      "description": "Envía notificación Telegram cuando un subagente termina su turno. INERTE por default: SubagentStop no está en los eventos default del script compartido porque duplica la notificación del Stop final (mismo cuerpo, dos mensajes). Activar con CLAUDE_NOTIFY_EVENTS=Stop,Notification,SubagentStop. Best-effort: siempre exit 0. Opt-out global: SWL_NOTIFICACIONES_TELEGRAM=0.",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "auto-restaurar-settings.js": {
+      "event": "SessionStart",
+      "matcher": "",
+      "description": "Al inicio de cada sesión verifica que ~/.claude/settings.json contiene los hooks SWL registrados en ~/.claude/notifications/baseline-hooks.json. Si falta alguno, los restaura preservando todos los hooks ajenos al baseline. Backup obligatorio antes de cada modificación. Opt-out: SWL_NOTIFICACIONES_TELEGRAM=0.",
+      "blocking": false,
+      "async": false,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "session-briefing.js": {
+      "event": "SessionStart",
+      "matcher": "",
+      "description": "Briefing proactivo de inicio de sesión (Fase 12, ADR-0036): digest no solicitado de señales accionables del proyecto destino — ADRs Propuestos con reevaluación vencida, deuda con trigger por fecha cumplido, nudges sin accionar, gates en calibración con ventana cumplida, y trabajo de retoma pendiente. Máximo 5 ítems con acción ejecutable; silencio total sin señales nuevas; dedupe diario. Solo filesystem, presupuesto <200ms. Opt-out: SWL_BRIEFING=0.",
+      "blocking": false,
+      "async": false,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "captura-acciones-post.js": {
+      "event": "PostToolUse",
+      "matcher": "",
+      "description": "Captura señales de ACCIÓN del usuario (Fase 17): registra SHAs de commits del agente y hashes de escrituras (Write/Edit/MultiEdit), y detecta edición manual en caliente al re-leer un archivo modificado fuera de sesión. Encola en feedback-queue.jsonl con tipo:\"accion\" (esquema extendido backward-compatible). Sanitización PII obligatoria de evidencia. Opt-out: SWL_CAPTURAR_FEEDBACK=0.",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "captura-acciones-session.js": {
+      "event": "SessionStart",
+      "matcher": "",
+      "description": "Detecta señales de ACCIÓN del usuario ocurridas fuera de sesión (Fase 17): revert/reset de commits del agente, edición neta de archivos escritos por el agente, rechazo de plan y override de veredicto. Encola en feedback-queue.jsonl con tipo:\"accion\"; NO muestra al modelo (solo persiste). Skip si no hay repo git; presupuesto p95<400ms. Opt-out: SWL_CAPTURAR_FEEDBACK=0.",
+      "blocking": false,
+      "async": false,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "validar-planning-paths.js": {
+      "event": "PostToolUse",
+      "matcher": "Write|Edit|MultiEdit",
+      "description": "Advierte cuando una sesion crea un directorio top-level NUEVO en .planning/ fuera de la allowlist canonica (manifiestos/planning-paths.json). Atrapa divergencias es/en (auditoria/ vs audit/, ux/ vs design/) antes de que proliferen. Aplica reglas/analizar-directorios-antes-de-escribir.md, cierra DT-PLANNING-OUTPUT-PATHS (ADR-0031). Emite nudge kind: planning-path-divergente a .planning/evolution/nudges.jsonl. No bloquea (warn-only). Opt-out: SWL_PLANNING_PATHS=0.",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    }
+  }
+}