@saulwade/swl-ses 1.0.0

package/manifiestos/handoff-context.json

@@ -0,0 +1,223 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "handoff-context",
+  "title": "SWL Handoff Context Schemas",
+  "description": "Schemas para contexto de transferencia entre agentes SWL. Portados del patrón HandoffContext/PipelineContext de rowboat con adaptación al sistema de agentes Claude Code.",
+
+  "definitions": {
+
+    "HandoffContext": {
+      "type": "object",
+      "description": "Contexto mínimo de transferencia entre dos agentes. Incluye trazabilidad de la cadena y limite de profundidad.",
+      "required": ["reason", "parentAgent", "transferCount"],
+      "additionalProperties": false,
+      "properties": {
+        "reason": {
+          "type": "string",
+          "enum": ["direct_handoff", "pipeline_execution", "task_delegation", "escalation", "review_request"],
+          "description": "Motivo de la transferencia. 'escalation' para problemas que superan capacidad del agente origen. 'review_request' para validación de calidad."
+        },
+        "parentAgent": {
+          "type": "string",
+          "description": "Nombre del agente que origina la transferencia (ej: 'orquestador-swl', 'planificador-swl')."
+        },
+        "transferCount": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 10,
+          "description": "Número de transferencias desde el agente raíz. Si supera 10, el agente debe rechazar y reportar loop al usuario."
+        },
+        "sessionId": {
+          "type": "string",
+          "description": "ID de la sesión de Claude Code para correlación con run-log.js."
+        },
+        "metadata": {
+          "type": "object",
+          "description": "Datos adicionales específicos del dominio (libre). No incluir datos sensibles ni contexto de conversación completo.",
+          "additionalProperties": true
+        }
+      }
+    },
+
+    "PipelineContext": {
+      "type": "object",
+      "description": "Contexto enriquecido para ejecución de pipelines multi-agente (ej: fases del PLAN.md). Extiende HandoffContext con estado del pipeline.",
+      "required": ["reason", "parentAgent", "transferCount", "pipelineName", "currentStep", "totalSteps"],
+      "additionalProperties": false,
+      "properties": {
+        "reason": {
+          "type": "string",
+          "enum": ["pipeline_execution"],
+          "description": "Siempre 'pipeline_execution' para este schema."
+        },
+        "parentAgent": {
+          "type": "string"
+        },
+        "transferCount": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 10
+        },
+        "sessionId": {
+          "type": "string"
+        },
+        "pipelineName": {
+          "type": "string",
+          "description": "Nombre del pipeline o fase (ej: 'fase-2-backend', 'ejecutar-plan-v3')."
+        },
+        "currentStep": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Número del paso actual (base 1)."
+        },
+        "totalSteps": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Total de pasos del pipeline."
+        },
+        "isLastStep": {
+          "type": "boolean",
+          "description": "true si currentStep === totalSteps."
+        },
+        "stepResults": {
+          "type": "array",
+          "description": "Resultados acumulados de pasos anteriores. Cada agente SOLO recibe los resultados relevantes para su paso, no el array completo.",
+          "items": {
+            "type": "object",
+            "required": ["step", "agentName"],
+            "properties": {
+              "step": {
+                "type": "integer",
+                "description": "Número del paso que produjo este resultado."
+              },
+              "agentName": {
+                "type": "string",
+                "description": "Agente que produjo este resultado."
+              },
+              "output": {
+                "type": "object",
+                "description": "Output estructurado del paso (artefactos: paths, resúmenes, decisiones).",
+                "additionalProperties": true
+              },
+              "status": {
+                "type": "string",
+                "enum": ["completed", "skipped", "failed"],
+                "default": "completed"
+              }
+            }
+          }
+        },
+        "pipelineData": {
+          "type": "object",
+          "description": "Datos compartidos mutables del pipeline (estado acumulado accesible por todos los pasos).",
+          "additionalProperties": true
+        },
+        "metadata": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      }
+    },
+
+    "TaskDelegationContext": {
+      "type": "object",
+      "description": "Contexto para delegación de una tarea específica del PLAN.md a un agente especializado.",
+      "required": ["reason", "parentAgent", "transferCount", "taskId", "taskDescription"],
+      "additionalProperties": false,
+      "properties": {
+        "reason": {
+          "type": "string",
+          "enum": ["task_delegation"]
+        },
+        "parentAgent": {
+          "type": "string"
+        },
+        "transferCount": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 10
+        },
+        "sessionId": {
+          "type": "string"
+        },
+        "taskId": {
+          "type": "string",
+          "description": "ID de la tarea del PLAN.md (ej: 'T-03')."
+        },
+        "taskDescription": {
+          "type": "string",
+          "maxLength": 500,
+          "description": "Descripción completa de la tarea del plan (self-contained, sin referencias a otros docs)."
+        },
+        "verificationCriteria": {
+          "type": "string",
+          "description": "Criterio de verificación de la tarea (copiado del PLAN.md)."
+        },
+        "relevantFiles": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Lista de archivos relevantes para la tarea (file:line cuando aplica)."
+        },
+        "previousTaskOutputs": {
+          "type": "array",
+          "description": "Outputs de tareas previas que esta tarea depende.",
+          "items": {
+            "type": "object",
+            "properties": {
+              "taskId":    { "type": "string" },
+              "output":    { "type": "object", "additionalProperties": true }
+            }
+          }
+        },
+        "metadata": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      }
+    }
+
+  },
+
+  "oneOf": [
+    { "$ref": "#/definitions/HandoffContext" },
+    { "$ref": "#/definitions/PipelineContext" },
+    { "$ref": "#/definitions/TaskDelegationContext" }
+  ],
+
+  "examples": [
+    {
+      "comment": "HandoffContext — orquestador delega al planificador",
+      "reason": "direct_handoff",
+      "parentAgent": "orquestador-swl",
+      "transferCount": 1,
+      "sessionId": "abc123",
+      "metadata": { "requestType": "feature", "priority": "high" }
+    },
+    {
+      "comment": "PipelineContext — ejecutar-fase pasa resultados del paso 2 al paso 3",
+      "reason": "pipeline_execution",
+      "parentAgent": "implementador-swl",
+      "transferCount": 3,
+      "sessionId": "abc123",
+      "pipelineName": "fase-2-backend",
+      "currentStep": 3,
+      "totalSteps": 7,
+      "isLastStep": false,
+      "stepResults": [
+        { "step": 1, "agentName": "implementador-swl", "output": { "schemaPath": "src/models/user.ts" }, "status": "completed" },
+        { "step": 2, "agentName": "backend-python-swl", "output": { "migrationPath": "db/migrations/001.sql" }, "status": "completed" }
+      ]
+    },
+    {
+      "comment": "TaskDelegationContext — orquestador delega T-03 al backend-python-swl",
+      "reason": "task_delegation",
+      "parentAgent": "orquestador-swl",
+      "transferCount": 1,
+      "sessionId": "abc123",
+      "taskId": "T-03",
+      "taskDescription": "Implementar endpoint POST /users con validación Pydantic v2 y persistencia SQLAlchemy async.",
+      "verificationCriteria": "curl -X POST /users devuelve 201 con { id, email, created_at }",
+      "relevantFiles": ["src/routers/users.py:1", "src/models/user.py:45", "src/schemas/user.py"]
+    }
+  ]
+}

package/manifiestos/hook-profiles.json

@@ -0,0 +1,44 @@
+{
+  "descripcion": "Perfiles de hooks SWL. Cada perfil define que hooks se activan y configuracion de umbrales.",
+  "perfilActivo": "standard",
+  "perfiles": {
+    "minimal": {
+      "descripcion": "Solo seguridad básica — ideal para proyectos personales y exploración",
+      "hooks": ["escaneo-secretos.js", "proteccion-rutas.js"],
+      "overrides": {}
+    },
+    "standard": {
+      "descripcion": "Seguridad + calidad + observabilidad — recomendado para equipos",
+      "hooks": [
+        "escaneo-secretos.js",
+        "proteccion-rutas.js",
+        "calidad-pre-commit.js",
+        "linea-estado.js",
+        "monitor-contexto.js",
+        "risk-scoring.js",
+        "inyeccion-contexto.js"
+      ],
+      "overrides": {}
+    },
+    "strict": {
+      "descripcion": "Todos los hooks + umbrales estrictos — producción y compliance",
+      "hooks": ["*"],
+      "overrides": {
+        "riskThresholds": {
+          "allow": 0.25,
+          "review": 0.45,
+          "confirm": 0.70
+        }
+      }
+    },
+    "custom": {
+      "descripcion": "Perfil personalizable — el usuario define que hooks activar",
+      "hooks": [],
+      "overrides": {}
+    }
+  },
+  "variablesEntorno": {
+    "SWL_HOOK_PROFILE": "Override del perfil activo (minimal|standard|strict|custom)",
+    "SWL_DISABLED_HOOKS": "Lista de hooks desactivados separados por coma (ej: extraccion-aprendizajes.js,degradacion-instintos.js)"
+  }
+}

package/manifiestos/hooks-config.json

@@ -0,0 +1,360 @@
+{
+  "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.60,
+    "confirm": 0.85
+  },
+  "costBudget": {
+    "maxUsd": 10.0,
+    "maxTokens": 500000,
+    "alertAt": 0.80
+  },
+  "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"
+    },
+    "linea-estado.js": {
+      "event": "PostToolUse",
+      "matcher": "",
+      "description": "Muestra linea de estado con modelo, tarea y porcentaje de contexto",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "monitor-contexto.js": {
+      "event": "PostToolUse",
+      "matcher": "",
+      "description": "Alerta cuando el contexto supera umbrales de saturacion (65% warning, 75% critical)",
+      "blocking": false,
+      "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"
+    },
+    "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"
+    },
+    "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"
+    },
+    "actualizar-perfil-usuario.js": {
+      "event": "Stop",
+      "matcher": "",
+      "description": "Detecta señales de corrección/preferencia del usuario y acumula un dirty-bit en .planning/perfil-usuario/. Emite nudge a perfilador-usuario-swl cuando cruza el umbral (default 3 señales).",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "degradeOnFailure": "skip"
+    },
+    "metricas-evolucion.js": {
+      "event": "Stop",
+      "matcher": "",
+      "description": "Consolida métricas del ciclo de evolución (nudges accionados/pendientes, instintos, fallos de agentes, evoluciones aplicadas/revertidas) y actualiza .planning/evolucion/metricas.json con health_score compuesto. Dispara escalamiento a alertas persistentes si >=5 nudges del mismo tipo ignorados en 14d.",
+      "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"
+    },
+    "auto-evolucion.js": {
+      "event": "SubagentStop",
+      "matcher": "",
+      "description": "Registra cada terminación de subagente SWL en .planning/auto-evolucion/agentes.jsonl y emite nudge a /swl:evolucionar cuando un agente acumula fallos o volumen de runs (ventana 14 días, throttle 24h).",
+      "blocking": false,
+      "async": true,
+      "maxConsecutiveFailures": 5,
+      "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"
+    },
+    "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"
+    },
+    "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/evolucion/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/evolucion/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"
+    },
+    "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. 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"
+    },
+    "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"
+    }
+  }
+}