refacil-sdd-ai 4.0.9 → 4.0.10

package/README.md

@@ -99,7 +99,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 +149,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 |

package/bin/cli.js

@@ -418,7 +418,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>]

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "refacil-sdd-ai",
-  "version": "4.0.9",
+  "version": "4.0.10",
   "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/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/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. |