refacil-sdd-ai 4.0.2 → 4.0.3

package/README.md

@@ -72,7 +72,7 @@ npm uninstall -g refacil-sdd-ai
 | Comando | Descripcion |
 |---|---|
 | `refacil-sdd-ai check-update` | (`SessionStart`) Verifica nueva version, sincroniza skills y `compact-guidance` en AGENTS.md |
-| `refacil-sdd-ai notify-update` | (`UserPromptSubmit`) Notifica al LLM sobre migraciones pendientes en el primer mensaje del usuario |
+| `refacil-sdd-ai notify-update` | (`Stop` / `afterAgentResponse`) Notifica al LLM sobre migraciones pendientes al finalizar la primera respuesta; el agente ejecuta `/refacil:update` automaticamente |
 | `refacil-sdd-ai check-review` | (`PreToolUse`) Bloquea `git push` si falta `.review-passed` en algun cambio activo |
 | `refacil-sdd-ai compact-bash` | (`PreToolUse`) Reescribe comandos Bash bare via `updatedInput` |
 
@@ -234,13 +234,13 @@ Se instalan en `.claude/settings.json` **y** `.cursor/settings.json` durante `in
 | Hook | Evento | Que hace |
 |---|---|---|
 | `check-update` | `SessionStart` | Chequea nueva version en npm, la instala, sincroniza skills y **sincroniza el bloque `compact-guidance`** en `AGENTS.md`. Si hubo actualizacion, escribe un flag de notificacion para el siguiente hook. |
-| `notify-update` | `UserPromptSubmit` | Lee el flag de actualizacion pendiente. Si existe, lo inyecta como `[ACCION REQUERIDA]` en el contexto del primer mensaje del usuario para que el LLM lo procese y ofrezca ejecutar `/refacil:update`. El flag se borra tras notificar. |
+| `notify-update` | `Stop` (Claude Code) / `afterAgentResponse` (Cursor) | Al finalizar la primera respuesta del agente, lee el flag de actualizacion pendiente. Si existe, inyecta la instruccion de ejecutar `/refacil:update` — el agente la ejecuta automaticamente y el usuario ve el resultado al final. El flag se borra tras notificar. |
 | `compact-bash` | `PreToolUse` (Bash) | Reescribe silenciosamente comandos Bash bare via `updatedInput`. Sin turnos extra, sin que el IDE vea el cambio. Requiere Claude Code >= 2.1.89. |
 | `check-review` | `PreToolUse` (Bash) | Intercepta `git push` y bloquea si falta `.review-passed` en algun cambio activo. |
 
 Los cuatro hooks se instalan en `.claude/settings.json` (Claude Code) y `.cursor/settings.json` (Cursor) con la misma logica parametrica.
 
-> **Por que dos hooks para el update?** `SessionStart` hace el sync silencioso al abrir la sesion, pero el LLM no genera respuesta hasta que el usuario escribe algo. `notify-update` en `UserPromptSubmit` garantiza que la notificacion llegue pegada al primer mensaje real del usuario y no sea ignorada.
+> **Por que dos hooks para el update?** `SessionStart` hace el sync silencioso al abrir la sesion sin interaccion del usuario. `notify-update` en `Stop` se dispara al finalizar la primera respuesta del agente — la instruccion queda al final visible para el usuario y Claude la ejecuta automaticamente en el siguiente turno.
 
 ### Gate de review en el push
 

package/bin/cli.js

@@ -57,8 +57,8 @@ function notifyUpdate() {
 
   const fromLabel = info.from ? `v${info.from}` : 'version desconocida';
   console.log(
-    `[refacil-sdd-ai] ACCION REQUERIDA: La metodologia fue actualizada (${fromLabel} → v${info.to}). ` +
-    'Antes de responder al usuario, informa del cambio y ofrece ejecutar /refacil:update para aplicar las migraciones pendientes.',
+    `[refacil-sdd-ai] La metodologia fue actualizada (${fromLabel} → v${info.to}). ` +
+    'Ejecuta /refacil:update ahora para aplicar las migraciones pendientes e informa el resultado al usuario.',
   );
 }
 

package/lib/hooks.js

@@ -31,11 +31,13 @@ function installHooks(ideDir, projectRoot) {
     changed = true;
   }
 
-  if (!settings.hooks.UserPromptSubmit) settings.hooks.UserPromptSubmit = [];
+  // Claude Code usa "Stop"; Cursor usa "afterAgentResponse" (equivalente al fin de turno del agente)
+  const notifyEvent = ideDir === '.cursor' ? 'afterAgentResponse' : 'Stop';
+  if (!settings.hooks[notifyEvent]) settings.hooks[notifyEvent] = [];
 
-  const hasNotifyHook = settings.hooks.UserPromptSubmit.some((h) => h._sdd_notify === true);
+  const hasNotifyHook = settings.hooks[notifyEvent].some((h) => h._sdd_notify === true);
   if (!hasNotifyHook) {
-    settings.hooks.UserPromptSubmit.push({
+    settings.hooks[notifyEvent].push({
       _sdd_notify: true,
       matcher: '',
       hooks: [{ type: 'command', command: 'refacil-sdd-ai notify-update' }],
@@ -99,13 +101,13 @@ function uninstallHooks(ideDir, projectRoot) {
     if (settings.hooks.SessionStart.length === 0) delete settings.hooks.SessionStart;
   }
 
-  if (Array.isArray(settings.hooks.UserPromptSubmit)) {
-    const original = settings.hooks.UserPromptSubmit.length;
-    settings.hooks.UserPromptSubmit = settings.hooks.UserPromptSubmit.filter(
-      (h) => h._sdd_notify !== true,
-    );
-    if (settings.hooks.UserPromptSubmit.length !== original) changed = true;
-    if (settings.hooks.UserPromptSubmit.length === 0) delete settings.hooks.UserPromptSubmit;
+  for (const notifyEvent of ['Stop', 'afterAgentResponse']) {
+    if (Array.isArray(settings.hooks[notifyEvent])) {
+      const original = settings.hooks[notifyEvent].length;
+      settings.hooks[notifyEvent] = settings.hooks[notifyEvent].filter((h) => h._sdd_notify !== true);
+      if (settings.hooks[notifyEvent].length !== original) changed = true;
+      if (settings.hooks[notifyEvent].length === 0) delete settings.hooks[notifyEvent];
+    }
   }
 
   if (Array.isArray(settings.hooks.PreToolUse)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "refacil-sdd-ai",
-  "version": "4.0.2",
+  "version": "4.0.3",
   "description": "SDD-AI: Specification-Driven Development with AI — metodologia de desarrollo con IA usando OpenSpec, Claude Code y Cursor",
   "bin": {
     "refacil-sdd-ai": "./bin/cli.js"