refacil-sdd-ai 4.0.3 → 4.0.4

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` | (`Stop` / `afterAgentResponse`) Notifica al LLM sobre migraciones pendientes al finalizar la primera respuesta; el agente ejecuta `/refacil:update` automaticamente |
+| `refacil-sdd-ai notify-update` | (`UserPromptSubmit` / `beforeSubmitPrompt`) Pregunta al usuario si desea ejecutar `/refacil:update` cuando hay migraciones pendientes |
 | `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` | `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. |
+| `notify-update` | `UserPromptSubmit` (Claude Code) / `beforeSubmitPrompt` (Cursor) | Antes de procesar el siguiente mensaje del usuario, lee el flag de actualizacion pendiente. Si existe, inyecta la instruccion para que el agente pregunte al usuario si desea ejecutar `/refacil:update`. 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 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.
+> **Por que dos hooks para el update?** `SessionStart` hace el sync silencioso al abrir la sesion sin interaccion del usuario. `notify-update` en `UserPromptSubmit` / `beforeSubmitPrompt` inyecta la instruccion justo antes de que el agente procese el siguiente mensaje del usuario, garantizando que no se ignore.
 
 ### Gate de review en el push
 

package/bin/cli.js

@@ -57,8 +57,9 @@ function notifyUpdate() {
 
   const fromLabel = info.from ? `v${info.from}` : 'version desconocida';
   console.log(
-    `[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.',
+    `[refacil-sdd-ai] La metodologia SDD-AI fue actualizada (${fromLabel} → v${info.to}). ` +
+    'IMPORTANTE: antes de continuar, pregunta al usuario si desea aplicar las migraciones pendientes ' +
+    'y, si confirma, ejecuta /refacil:update.',
   );
 }
 

package/lib/hooks.js

@@ -31,8 +31,8 @@ function installHooks(ideDir, projectRoot) {
     changed = true;
   }
 
-  // Claude Code usa "Stop"; Cursor usa "afterAgentResponse" (equivalente al fin de turno del agente)
-  const notifyEvent = ideDir === '.cursor' ? 'afterAgentResponse' : 'Stop';
+  // Claude Code usa "UserPromptSubmit"; Cursor usa "beforeSubmitPrompt"
+  const notifyEvent = ideDir === '.cursor' ? 'beforeSubmitPrompt' : 'UserPromptSubmit';
   if (!settings.hooks[notifyEvent]) settings.hooks[notifyEvent] = [];
 
   const hasNotifyHook = settings.hooks[notifyEvent].some((h) => h._sdd_notify === true);
@@ -101,7 +101,7 @@ function uninstallHooks(ideDir, projectRoot) {
     if (settings.hooks.SessionStart.length === 0) delete settings.hooks.SessionStart;
   }
 
-  for (const notifyEvent of ['Stop', 'afterAgentResponse']) {
+  for (const notifyEvent of ['UserPromptSubmit', 'beforeSubmitPrompt', '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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "refacil-sdd-ai",
-  "version": "4.0.3",
+  "version": "4.0.4",
   "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"