refacil-sdd-ai 4.0.9 → 4.0.11

package/README.md

@@ -64,6 +64,7 @@ npm uninstall -g refacil-sdd-ai
 |---|---|
 | `refacil-sdd-ai init` | Instala skills y hooks en el repo actual |
 | `refacil-sdd-ai update` | Re-copia skills y hooks a la ultima version |
+| `refacil-sdd-ai migration-pending [--json]` | Misma deteccion que hooks/`notify-update`; exit 1 si hay migracion de metodologia pendiente (uso en `/refacil:update`) |
 | `refacil-sdd-ai clean` | Elimina skills y hooks SDD-AI del repo |
 | `refacil-sdd-ai help` | Ver ayuda |
 
@@ -72,7 +73,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` / `beforeSubmitPrompt`) Pregunta al usuario si desea ejecutar `/refacil:update` cuando hay migraciones pendientes |
+| `refacil-sdd-ai notify-update` | (`UserPromptSubmit` / `beforeSubmitPrompt`) Solo actua si hay migracion de metodologia pendiente (misma logica que `/refacil:update`); si no, no interrumpe |
 | `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` |
 
@@ -99,7 +100,7 @@ npm uninstall -g refacil-sdd-ai
 | `refacil-sdd-ai bus join --room <sala> [--session <s>] [--intro "..."]` | Unirse a sala (las skills lo hacen) |
 | `refacil-sdd-ai bus leave [--session <s>]` | Salir de la sala |
 | `refacil-sdd-ai bus say --text "..." [--session <s>]` | Broadcast (las skills lo hacen) |
-| `refacil-sdd-ai bus ask --to <name> --text "..." [--wait N]` | Pregunta dirigida (las skills lo hacen) |
+| `refacil-sdd-ai bus ask --to <sesión> --text "..." [--wait N]` | Pregunta dirigida; `--to all` (también `*` o `everyone`) envía un ask a cada miembro de la sala excepto tú |
 | `refacil-sdd-ai bus reply --text "..." [--correlation <id>]` | Responder (las skills lo hacen) |
 | `refacil-sdd-ai bus attend [--timeout N]` | Escucha preguntas dirigidas (las skills lo hacen) |
 | `refacil-sdd-ai bus inbox [--session <s>]` | Ver mensajes nuevos |
@@ -149,7 +150,7 @@ Algunos skills delegan su trabajo pesado a **sub-agentes** que corren en context
 |---|---|
 | `/refacil:join <sala>` | Unirse o crear sala |
 | `/refacil:say "..."` | Broadcast |
-| `/refacil:ask @nombre "..." [--wait N]` | Pregunta dirigida (bloquea con `--wait`) |
+| `/refacil:ask @nombre "..." [--wait N]` | Pregunta dirigida; `@all` pregunta a todos en la sala (bloquea con `--wait` hasta la **primera** respuesta) |
 | `/refacil:reply "..."` | Responder ultima pregunta (autocompleta `correlationId`) |
 | `/refacil:attend` | Modo escucha activa |
 | `/refacil:inbox` | Mensajes nuevos desde la ultima lectura |
@@ -234,7 +235,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. |
-| `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. |
+| `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

@@ -25,6 +25,7 @@ const { installHooks, uninstallHooks, cleanLegacySettingsHooks } = require('../l
 const { handleCompact } = require('../lib/commands/compact');
 const { handleBus } = require('../lib/commands/bus');
 const { syncIgnoreFiles } = require('../lib/ignore-files');
+const { methodologyMigrationPending } = require('../lib/methodology-migration-pending');
 
 const packageRoot = path.resolve(__dirname, '..');
 const projectRoot = process.cwd();
@@ -62,6 +63,12 @@ function notifyUpdate() {
   let info = {};
   try { info = JSON.parse(fs.readFileSync(flagPath, 'utf8')); } catch (_) {}
 
+  const mig = methodologyMigrationPending(projectRoot);
+  if (!mig.pending) {
+    try { fs.unlinkSync(flagPath); } catch (_) {}
+    return;
+  }
+
   const fromLabel = info.from ? `v${info.from}` : 'version anterior';
 
   // Si el usuario ya está ejecutando /refacil:update, dejar pasar y borrar el flag
@@ -145,6 +152,20 @@ function syncRepoSkillsIfStale(globalVersion) {
   }
 }
 
+function migrationPendingCmd() {
+  const wantJson = process.argv.includes('--json');
+  const { pending, reasons } = methodologyMigrationPending(projectRoot);
+  if (wantJson) {
+    process.stdout.write(`${JSON.stringify({ pending, reasons })}\n`);
+  } else if (pending) {
+    console.log('  Migraciones de metodologia pendientes:');
+    for (const r of reasons) console.log(`    - ${r}`);
+  } else {
+    console.log('  Sin migraciones de metodologia pendientes (criterio alineado con hooks y /refacil:update).');
+  }
+  process.exit(pending ? 1 : 0);
+}
+
 function checkUpdate() {
   const { execSync } = require('child_process');
   let localVersion = getPackageVersion(packageRoot);
@@ -188,7 +209,9 @@ function checkUpdate() {
       `[refacil-sdd-ai] Skills de este repo sincronizadas (${fromLabel} -> v${syncResult.to}). ` +
       'Reinicia la sesion de Claude Code o Cursor para detectar los cambios.',
     );
-    writePendingUpdateFlag(projectRoot, syncResult.from, syncResult.to);
+    if (methodologyMigrationPending(projectRoot).pending) {
+      writePendingUpdateFlag(projectRoot, syncResult.from, syncResult.to);
+    }
   } else if (syncResult && syncResult.failed) {
     console.log(
       `[refacil-sdd-ai] Skills de este repo estan desactualizadas respecto al paquete global (v${syncResult.to}) ` +
@@ -401,8 +424,9 @@ function help() {
   Comandos:
     init          Instala skills en .claude/ y .cursor/, crea CLAUDE.md y .cursorrules
     update        Re-copia skills (para actualizar a nueva version del paquete)
+    migration-pending  Misma validacion que hooks/notify-update: lista migraciones (exit 1 si hay; --json)
     check-update   Sincroniza skills y compact-guidance al inicio de sesion (hook SessionStart)
-    notify-update  Notifica al LLM sobre migraciones pendientes (hook UserPromptSubmit)
+    notify-update  Notifica migracion de metodologia solo si aplica (hook UserPromptSubmit)
     check-review   Verifica que el review se haya completado (usado por hook PreToolUse)
     compact-bash  Reescribe comandos Bash bare para reducir tokens (usado por hook PreToolUse)
     compact       Subcomandos del hook compact-bash:
@@ -418,7 +442,7 @@ function help() {
                     bus join --room <sala> [--session <s>] [--intro "..."]
                     bus leave [--session <s>]
                     bus say --text "..." [--session <s>]
-                    bus ask --to <name> --text "..." [--wait N] [--session <s>]
+                    bus ask --to <name|all|*|everyone> --text "..." [--wait N] [--session <s>]
                     bus reply --text "..." [--correlation <id>] [--to <name>]
                     bus history [--n N] [--session <s>]
                     bus inbox [--session <s>]
@@ -452,6 +476,9 @@ switch (command) {
   case 'update':
     update();
     break;
+  case 'migration-pending':
+    migrationPendingCmd();
+    break;
   case 'check-update':
     checkUpdate();
     break;

package/lib/bus/askFulfillment.js

@@ -0,0 +1,17 @@
+'use strict';
+
+/**
+ * Indica si el `ask` ya tiene una respuesta que lo cierra para este hilo.
+ * Para el mismo correlationId con varios destinatarios (@all), solo cuenta
+ * la respuesta emitida por la sesión que recibió ese ask (ask.to).
+ */
+function askHasMatchingReply(messages, ask) {
+  if (!ask || ask.kind !== 'ask' || !ask.correlationId) return true;
+  return messages.some((m) => {
+    if (m.kind !== 'reply' || m.correlationId !== ask.correlationId) return false;
+    if (ask.to) return m.from === ask.to;
+    return m.to === ask.from;
+  });
+}
+
+module.exports = { askHasMatchingReply };

package/lib/bus/broker.js

@@ -12,6 +12,7 @@ const PORT_CANDIDATES = [7821, 7822, 7823];
 const HOST = '127.0.0.1';
 
 const storage = require('./storage');
+const { askHasMatchingReply } = require('./askFulfillment');
 
 let WebSocketServer;
 try {
@@ -258,6 +259,24 @@ function handleLeave(state, ws, data) {
   persistSessions(state);
 }
 
+/** Destinos especiales: un ask por cada miembro de la sala excepto el emisor. */
+const ASK_ALL_ALIASES = new Set(['all', '*', 'everyone']);
+
+function resolveAskTargets(state, room, fromSession, rawTo) {
+  if (rawTo === undefined || rawTo === null) return [null];
+  const trimmed = String(rawTo).trim();
+  if (trimmed === '') return [null];
+  const bare = trimmed.replace(/^@/, '');
+  const key = bare.toLowerCase();
+  if (ASK_ALL_ALIASES.has(key)) {
+    const members = state.rooms.get(room);
+    if (!members || members.size === 0) return [];
+    const others = Array.from(members).filter((n) => n !== fromSession);
+    return others.length ? others.sort() : [];
+  }
+  return [bare];
+}
+
 function handleSay(state, ws, data) {
   const session = data.session || ws._refacilSession;
   const s = session && state.sessions.get(session);
@@ -284,19 +303,36 @@ function handleAsk(state, ws, data) {
   if (!s || !s.room) {
     return send(ws, { type: 'system', event: 'error', detail: 'sesión no está en ninguna sala' });
   }
-  const msg = {
-    id: newId(),
-    ts: nowIso(),
-    from: session,
-    to: data.to || null,
-    room: s.room,
-    text: data.text || '',
-    kind: 'ask',
-    correlationId: data.correlationId || newId(),
-  };
-  appendHistory(state, s.room, msg);
-  broadcast(state, s.room, msg);
-  send(ws, { type: 'system', event: 'sent', detail: { id: msg.id, correlationId: msg.correlationId } });
+  const correlationId = data.correlationId || newId();
+  const targets = resolveAskTargets(state, s.room, session, data.to);
+  if (targets.length === 0) {
+    return send(ws, {
+      type: 'system',
+      event: 'error',
+      detail: 'sin destinatarios (@all en sala vacía o solo tú)',
+    });
+  }
+  let firstId = null;
+  for (const to of targets) {
+    const msg = {
+      id: newId(),
+      ts: nowIso(),
+      from: session,
+      to,
+      room: s.room,
+      text: data.text || '',
+      kind: 'ask',
+      correlationId,
+    };
+    if (!firstId) firstId = msg.id;
+    appendHistory(state, s.room, msg);
+    broadcast(state, s.room, msg);
+  }
+  send(ws, {
+    type: 'system',
+    event: 'sent',
+    detail: { id: firstId, correlationId, fanOut: targets.length },
+  });
 }
 
 function handleReply(state, ws, data) {
@@ -315,9 +351,7 @@ function handleReply(state, ws, data) {
     for (const ask of hist) {
       if (ask.kind !== 'ask') continue;
       if (ask.to && ask.to !== session) continue;
-      const replied = hist.some(
-        (m) => m.kind === 'reply' && m.correlationId === ask.correlationId,
-      );
+      const replied = askHasMatchingReply(hist, ask);
       if (replied) continue;
       correlationId = ask.correlationId || null;
       if (!toOverride) toOverride = ask.from;

package/lib/bus/ui/app.js

@@ -28,11 +28,23 @@
     rooms: {},
     knownRooms: new Set(),
     selectedRoom: '*',
-    askIndex: new Map(),
-    answeredCorrelations: new Set(),
+    answeredByResponder: new Set(),
     msgCount: 0,
   };
 
+  function cssEsc(s) {
+    if (typeof CSS !== 'undefined' && CSS.escape) return CSS.escape(String(s));
+    return String(s).replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+  }
+
+  function isAskAnswered(m) {
+    if (m.kind !== 'ask' || !m.correlationId) return false;
+    if (m.to) return state.answeredByResponder.has(`${m.correlationId}\t${m.to}`);
+    return state.messages.some(
+      (r) => r.kind === 'reply' && r.correlationId === m.correlationId,
+    );
+  }
+
   els.port.textContent = 'puerto ' + state.port;
 
   function setConn(kind, label) {
@@ -79,6 +91,9 @@
     div.className = classes.join(' ');
     div.dataset.corr = m.correlationId || '';
     div.dataset.kind = m.kind || '';
+    if (m.kind === 'ask' && m.correlationId && m.to) {
+      div.dataset.askTo = m.to;
+    }
 
     const head = document.createElement('div');
     head.className = 'msg-head';
@@ -103,7 +118,7 @@
 
     if (m.correlationId) {
       const corr = document.createElement('div');
-      const isAnswered = state.answeredCorrelations.has(m.correlationId);
+      const isAnswered = m.kind === 'ask' ? isAskAnswered(m) : false;
       corr.className = 'msg-corr ' + (m.kind === 'ask' ? (isAnswered ? 'answered' : 'pending') : '');
       corr.textContent = m.correlationId.slice(0, 8);
       div.appendChild(corr);
@@ -136,20 +151,21 @@
     state.messageIds.add(m.id);
     state.messages.push(m);
     state.msgCount++;
-    if (m.kind === 'ask' && m.correlationId) {
-      state.askIndex.set(m.correlationId, m);
-    }
-    if (m.kind === 'reply' && m.correlationId) {
-      state.answeredCorrelations.add(m.correlationId);
+    if (m.kind === 'reply' && m.correlationId && m.from) {
+      state.answeredByResponder.add(`${m.correlationId}\t${m.from}`);
     }
     return true;
   }
 
   function appendMsg(m) {
     if (!ingestMsg(m)) return; // dedup
-    if (m.kind === 'reply' && m.correlationId) {
-      const prev = els.feedBody.querySelector(`.msg.ask[data-corr="${m.correlationId}"] .msg-corr`);
-      if (prev) { prev.className = 'msg-corr answered'; prev.textContent = m.correlationId.slice(0, 8); }
+    if (m.kind === 'reply' && m.correlationId && m.from) {
+      const sel = `.msg.ask[data-corr="${cssEsc(m.correlationId)}"][data-ask-to="${cssEsc(m.from)}"] .msg-corr`;
+      const prev = els.feedBody.querySelector(sel);
+      if (prev) {
+        prev.className = 'msg-corr answered';
+        prev.textContent = m.correlationId.slice(0, 8);
+      }
     }
     const node = renderMsg(m);
     if (node) {
@@ -176,10 +192,10 @@
 
   function updateStats() {
     els.msgCount.textContent = state.msgCount;
-    els.pairCount.textContent = state.answeredCorrelations.size;
+    els.pairCount.textContent = state.messages.filter((x) => x.kind === 'reply').length;
     let pending = 0;
-    for (const [cid] of state.askIndex) {
-      if (!state.answeredCorrelations.has(cid)) pending++;
+    for (const m of state.messages) {
+      if (m.kind === 'ask' && !isAskAnswered(m)) pending++;
     }
     els.pendingCount.textContent = pending;
   }
@@ -238,8 +254,8 @@
     });
     els.clearBtn.addEventListener('click', () => {
       state.messages = [];
-      state.askIndex.clear();
-      state.answeredCorrelations.clear();
+      state.messageIds.clear();
+      state.answeredByResponder.clear();
       state.msgCount = 0;
       rerenderFeed();
       updateStats();

package/lib/commands/bus.js

@@ -7,6 +7,7 @@ const busSpawn = require('../bus/spawn');
 const busClient = require('../bus/client');
 const busWatch = require('../bus/watch');
 const busPresenter = require('../bus/presenter');
+const { askHasMatchingReply } = require('../bus/askFulfillment');
 
 function parseBusArgs(argv) {
   const args = {};
@@ -185,7 +186,7 @@ async function busAsk(args, packageRoot) {
   const text = args.text;
   const waitSec = args.wait ? parseInt(args.wait, 10) : 0;
   if (!to || !text) {
-    console.error('  Uso: refacil-sdd-ai bus ask --to <name> --text "..." [--wait N] [--session <s>]');
+    console.error('  Uso: refacil-sdd-ai bus ask --to <name|all> --text "..." [--wait N] [--session <s>]');
     process.exit(1);
   }
   const { ws } = await connectOrDie(packageRoot);
@@ -203,7 +204,9 @@ async function busAsk(args, packageRoot) {
     process.exit(1);
   }
   const correlationId = ack.detail.correlationId;
-  console.log(`  Pregunta enviada a @${to.replace(/^@/, '')} (correlationId ${correlationId}).`);
+  const fanOut = ack.detail && ack.detail.fanOut;
+  const destLabel = fanOut && fanOut > 1 ? `${fanOut} miembros (@all)` : `@${to.replace(/^@/, '')}`;
+  console.log(`  Pregunta enviada a ${destLabel} (correlationId ${correlationId}).`);
 
   if (waitSec > 0) {
     console.log(`  Esperando respuesta hasta ${waitSec}s...`);
@@ -306,10 +309,7 @@ async function busInbox(args, packageRoot) {
 function findFirstUnansweredAsk(messages, session) {
   const asks = messages.filter((m) => m.kind === 'ask' && m.to === session);
   for (const ask of asks) {
-    const hasReply = messages.some(
-      (m) => m.kind === 'reply' && m.correlationId === ask.correlationId,
-    );
-    if (!hasReply) return ask;
+    if (!askHasMatchingReply(messages, ask)) return ask;
   }
   return null;
 }

package/lib/methodology-migration-pending.js

@@ -0,0 +1,136 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Motor compartido con `refacil-sdd-ai migration-pending`, hooks `check-update` / `notify-update`
+ * y la skill `refacil:update`. Si ninguna condicion aplica, no hace falta migrar metodologia.
+ */
+const REQUIRED_OPENSPEC_SKILLS = new Set([
+  'openspec-propose',
+  'openspec-explore',
+  'openspec-apply-change',
+  'openspec-archive-change',
+  'openspec-verify-change',
+]);
+
+const REQUIRED_OPSX_CLAUDE = new Set([
+  'apply.md',
+  'archive.md',
+  'explore.md',
+  'propose.md',
+  'verify.md',
+]);
+
+const REQUIRED_OPSX_CURSOR = new Set([
+  'opsx-apply.md',
+  'opsx-archive.md',
+  'opsx-explore.md',
+  'opsx-propose.md',
+  'opsx-verify.md',
+]);
+
+function legacyIndexDoc(filePath) {
+  if (!fs.existsSync(filePath)) return false;
+  const content = fs.readFileSync(filePath, 'utf8');
+  const lines = content.split(/\r?\n/).length;
+  const pointsToAgents = /AGENTS\.md/i.test(content);
+  return lines > 5 || !pointsToAgents;
+}
+
+function collectExtraOpenspecSkills(root) {
+  const out = [];
+  for (const rel of ['.claude/skills', '.cursor/skills']) {
+    const full = path.join(root, rel);
+    if (!fs.existsSync(full)) continue;
+    let names;
+    try {
+      names = fs.readdirSync(full, { withFileTypes: true });
+    } catch (_) {
+      continue;
+    }
+    for (const d of names) {
+      if (!d.isDirectory()) continue;
+      const name = d.name;
+      if (!name.startsWith('openspec-')) continue;
+      if (REQUIRED_OPENSPEC_SKILLS.has(name)) continue;
+      out.push(path.join(rel, name));
+    }
+  }
+  return out;
+}
+
+function collectExtraOpsxClaude(root) {
+  const dir = path.join(root, '.claude', 'commands', 'opsx');
+  if (!fs.existsSync(dir)) return [];
+  let names;
+  try {
+    names = fs.readdirSync(dir);
+  } catch (_) {
+    return [];
+  }
+  const extra = [];
+  for (const name of names) {
+    if (!name.endsWith('.md')) continue;
+    if (REQUIRED_OPSX_CLAUDE.has(name)) continue;
+    extra.push(path.join('.claude/commands/opsx', name));
+  }
+  return extra;
+}
+
+function collectExtraOpsxCursor(root) {
+  const dir = path.join(root, '.cursor', 'commands');
+  if (!fs.existsSync(dir)) return [];
+  let names;
+  try {
+    names = fs.readdirSync(dir);
+  } catch (_) {
+    return [];
+  }
+  const extra = [];
+  for (const name of names) {
+    if (!name.startsWith('opsx-') || !name.endsWith('.md')) continue;
+    if (REQUIRED_OPSX_CURSOR.has(name)) continue;
+    extra.push(path.join('.cursor/commands', name));
+  }
+  return extra;
+}
+
+/**
+ * @param {string} root - raíz del repo
+ * @returns {{ pending: boolean, reasons: string[] }}
+ */
+function methodologyMigrationPending(root) {
+  const reasons = [];
+
+  const agentsMd = path.join(root, 'AGENTS.md');
+  const agentsDir = path.join(root, '.agents');
+  if (fs.existsSync(agentsMd) && !fs.existsSync(agentsDir)) {
+    reasons.push('AGENTS.md existe sin carpeta .agents/');
+  }
+
+  const claudeMd = path.join(root, 'CLAUDE.md');
+  if (legacyIndexDoc(claudeMd)) {
+    reasons.push('CLAUDE.md requiere normalización (índice mínimo → AGENTS.md)');
+  }
+
+  const cursorRules = path.join(root, '.cursorrules');
+  if (legacyIndexDoc(cursorRules)) {
+    reasons.push('.cursorrules requiere normalización (índice mínimo → AGENTS.md)');
+  }
+
+  const extraSkills = collectExtraOpenspecSkills(root);
+  if (extraSkills.length) {
+    reasons.push(`skills OpenSpec sobrantes: ${extraSkills.join(', ')}`);
+  }
+
+  const extraOpsx = [...collectExtraOpsxClaude(root), ...collectExtraOpsxCursor(root)];
+  if (extraOpsx.length) {
+    reasons.push(`commands opsx sobrantes: ${extraOpsx.join(', ')}`);
+  }
+
+  return { pending: reasons.length > 0, reasons };
+}
+
+module.exports = { methodologyMigrationPending };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "refacil-sdd-ai",
-  "version": "4.0.9",
+  "version": "4.0.11",
   "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"
@@ -37,7 +37,7 @@
     "node": ">=20.19.0"
   },
   "scripts": {
-    "test": "node --test test/hooks.test.js test/installer.test.js test/ignore-files.test.js"
+    "test": "node --test test/hooks.test.js test/installer.test.js test/ignore-files.test.js test/methodology-migration-pending.test.js"
   },
   "dependencies": {
     "ws": "^8.18.0"

package/skills/ask/SKILL.md

@@ -6,7 +6,7 @@ user-invocable: true
 
 # refacil:ask — Pregunta dirigida a otra sesión
 
-Envía una pregunta dirigida a una sesión específica de la sala. **$ARGUMENTS** incluye `@<destino>` y el texto.
+Envía una pregunta dirigida a una sesión de la sala, o a **todas las demás** sesiones de la sala con `@all` (alias: `*`, `everyone`). **$ARGUMENTS** incluye `@<destino>` y el texto.
 
 ## Instrucciones
 
@@ -23,6 +23,8 @@ Extrae:
 
 Si el destino no es claro, usa `/refacil:rooms` (vía `refacil-sdd-ai bus rooms`) para listar sesiones activas y pide aclaración al usuario.
 
+**Broadcast dirigido (`@all`)**: el broker emite un `ask` por cada miembro (excepto quien pregunta), mismo `correlationId`. Cada receptor puede `/refacil:reply` por su lado. Con `--wait`, el CLI sigue devolviendo **la primera** respuesta que llegue (no espera a todos).
+
 ### Paso 2: Decidir si usar `--wait`
 
 Dos modos:

package/skills/update/SKILL.md

@@ -8,26 +8,41 @@ user-invocable: true
 
 Detecta el estado actual del repo y aplica solo lo que este pendiente. No repite pasos de instalacion (OpenSpec, hooks, skills).
 
-## Paso 1: Detectar migraciones pendientes
+El hook `notify-update` usa el **mismo motor** que este comando; no re-evalues a mano el repo para decidir si hay trabajo.
 
-Evalua cada condicion y marca si aplica:
+## Paso 1: Validar con el CLI (obligatorio)
 
-| # | Condicion detectada | Migracion |
+En la **raiz del repo** (donde esta `AGENTS.md` o `.claude/`), ejecuta con `Bash`:
+
+```bash
+refacil-sdd-ai migration-pending
+```
+
+- **Codigo de salida 0**: no hay migraciones de metodologia pendientes → informa al usuario que todo esta al dia respecto a este criterio y **termina** (sin tocar archivos).
+- **Codigo de salida 1**: hay al menos una razon listada en stdout → continua al Paso 2.
+
+Opcional para parseo estable: `refacil-sdd-ai migration-pending --json` → objeto `{ "pending": bool, "reasons": string[] }`.
+
+No sustituyas este paso por inspeccion manual del arbol salvo que el comando falle (error de entorno); en ese caso documenta el error y pide reintentar.
+
+### Referencia (mapeo razon → accion en Paso 3)
+
+La implementacion vive en `lib/methodology-migration-pending.js` del paquete; la tabla resume lo que detecta:
+
+| # | Condicion (resumen) | Migracion en Paso 3 |
 |---|---|---|
 | 1 | `AGENTS.md` existe y no existe carpeta `.agents/` | Reestructurar en `.agents/` + reescribir como indice |
 | 2 | `CLAUDE.md` tiene mas de 5 lineas o no apunta a `AGENTS.md` | Reemplazar por indice minimo |
 | 3 | `.cursorrules` tiene mas de 5 lineas o no apunta a `AGENTS.md` | Reemplazar por indice minimo |
-| 4 | Existen skills `openspec-*` o commands `opsx-*` fuera del conjunto requerido en `.claude/` o `.cursor/` | Eliminar los sobrantes y reconfigurar OpenSpec |
-
-Si ninguna condicion aplica: informar al usuario que todo esta al dia y salir sin cambios.
+| 4 | Skills `openspec-*` o commands `opsx-*` fuera del conjunto requerido | Eliminar sobrantes y reconfigurar OpenSpec |
 
 ## Paso 2: Confirmar con el usuario
 
-Mostrar la lista de migraciones detectadas y pedir confirmacion antes de aplicar cualquier cambio.
+Mostrar al usuario las mismas lineas que imprimio `migration-pending` (o el array `reasons` del JSON) y pedir confirmacion antes de aplicar cualquier cambio.
 
 ## Paso 3: Aplicar migraciones confirmadas
 
-Ejecutar solo las migraciones marcadas en el Paso 1.
+Ejecutar solo las migraciones que correspondan a las razones detectadas (ver tabla de referencia arriba).
 
 ### Migracion 1 — AGENTS.md → `.agents/` + indice
 
@@ -108,7 +123,8 @@ Informar que archivos se crearon o modificaron. Mencionar que el bloque `compact
 
 ## Reglas
 
+- **Deteccion**: confiar en `refacil-sdd-ai migration-pending` (mismo criterio que `check-update` / `notify-update`).
 - Solo aplica lo que este pendiente — no toca archivos que ya cumplen el patron.
 - No inventa contenido: distribuye lo que ya existe en AGENTS.md sin agregar ni eliminar informacion.
 - No ejecuta pasos de OpenSpec, hooks ni instalacion de skills.
-- Extensible: futuras versiones de la metodologia agregaran filas a la tabla del Paso 1 sin cambiar la estructura de la skill.
+- Extensible: nuevas reglas de deteccion se agregan en el paquete (`methodology-migration-pending.js`); esta skill actualiza la tabla de referencia y los pasos de aplicacion cuando cambie el contrato.

package/templates/methodology-guide.md

@@ -29,7 +29,7 @@ Canal local de texto plano entre sesiones de Claude Code / Cursor corriendo en d
 |---------|-------------|
 | `/refacil:join <sala>` | Crear o unirse a una sala. La primera vez genera un bloque de presentacion en `AGENTS.md`. |
 | `/refacil:say "..."` | Anuncio a toda la sala. |
-| `/refacil:ask @nombre "..." [--wait N]` | Pregunta dirigida a otra sesion. `--wait N` bloquea hasta respuesta o N seg. |
+| `/refacil:ask @nombre "..." [--wait N]` | Pregunta dirigida; `@all` (o `*`) pregunta a todos en la sala. `--wait N` bloquea hasta la primera respuesta o N seg. |
 | `/refacil:reply "..."` | Responde la ultima pregunta dirigida (autocompleta `correlationId`). |
 | `/refacil:attend` | Modo escucha activa: recibe preguntas y el LLM las responde, luego re-invoca para seguir escuchando. |
 | `/refacil:inbox` | Ver mensajes nuevos desde la ultima lectura. |