refacil-sdd-ai 4.0.11 → 4.1.0

package/README.md

@@ -234,7 +234,7 @@ 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. |
+| `check-update` | `SessionStart` | Al inicio borra `.refacil-pending-update` si ya no hay migracion (flags obsoletos). Luego: npm, sync skills, **compact-guidance**. Si hubo sync de skills y **si** hay migracion pendiente, escribe el flag para `notify-update`. |
 | `notify-update` | `UserPromptSubmit` (Claude Code) / `beforeSubmitPrompt` (Cursor) | Si existe flag y **hay migracion de metodologia pendiente** (misma tabla que `/refacil:update`), inyecta la instruccion o pausa el primer mensaje; si solo hubo sync de skills sin migracion, el flag no se crea o se descarta sin preguntar. |
 | `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. |

package/bin/cli.js

@@ -46,6 +46,15 @@ function writePendingUpdateFlag(root, fromVersion, toVersion) {
   } catch (_) {}
 }
 
+/** Borra `.refacil-pending-update` si ya no hay migracion (flags viejos o sync de skills sin migracion). */
+function clearStalePendingUpdateFlag(root) {
+  const flagPath = path.join(root, '.refacil-pending-update');
+  if (!fs.existsSync(flagPath)) return;
+  if (!methodologyMigrationPending(root).pending) {
+    try { fs.unlinkSync(flagPath); } catch (_) {}
+  }
+}
+
 function readStdinPrompt() {
   try {
     const raw = fs.readFileSync(0, 'utf8');
@@ -163,10 +172,13 @@ function migrationPendingCmd() {
   } else {
     console.log('  Sin migraciones de metodologia pendientes (criterio alineado con hooks y /refacil:update).');
   }
+  clearStalePendingUpdateFlag(projectRoot);
   process.exit(pending ? 1 : 0);
 }
 
 function checkUpdate() {
+  clearStalePendingUpdateFlag(projectRoot);
+
   const { execSync } = require('child_process');
   let localVersion = getPackageVersion(packageRoot);
 

package/package.json

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

package/skills/update/SKILL.md

@@ -111,12 +111,14 @@ Conjunto requerido de commands: `.claude/commands/opsx/` → `apply.md`, `archiv
 
 ## Paso 4: Limpiar flag de actualizacion pendiente
 
-Eliminar el archivo de flag si existe (puede estar en `.claude/` o `.cursor/`):
+Tras migrar, elimina el flag en la raiz del repo si sigue existiendo:
 
 ```bash
 rm -f .refacil-pending-update
 ```
 
+Si no hubo cambios (Paso 1 dio exit 0), el flag obsoleto suele borrarse solo al proximo `check-update` (SessionStart) o al ejecutar `refacil-sdd-ai migration-pending` con exit 0; el `rm` manual solo hace falta si aplicaste migraciones a mano o quedo un vestigio.
+
 ## Paso 5: Resumen
 
 Informar que archivos se crearon o modificaron. Mencionar que el bloque `compact-guidance` se sincronizara automaticamente en el proximo SessionStart.