refacil-sdd-ai 4.2.3 → 4.3.0

package/bin/cli.js

@@ -13,6 +13,7 @@ const {
   installSkills,
   installAgents,
   removeSkills,
+  removeOpenspecLegacyAssets,
   createClaudeMd,
   createCursorRules,
   readRepoVersion,
@@ -24,6 +25,7 @@ const {
 const { installHooks, uninstallHooks, cleanLegacySettingsHooks } = require('../lib/hooks');
 const { handleCompact } = require('../lib/commands/compact');
 const { handleBus } = require('../lib/commands/bus');
+const { handleSdd, autoMigrateOpenspec } = require('../lib/commands/sdd');
 const { syncIgnoreFiles } = require('../lib/ignore-files');
 const { methodologyMigrationPending } = require('../lib/methodology-migration-pending');
 
@@ -46,7 +48,7 @@ function writePendingUpdateFlag(root, fromVersion, toVersion) {
   } catch (_) {}
 }
 
-/** Borra `.refacil-pending-update` si ya no hay migracion (flags viejos o sync de skills sin migracion). */
+/** Clears `.refacil-pending-update` if there is no longer a pending migration (stale flags or skill sync without migration). */
 function clearStalePendingUpdateFlag(root) {
   const flagPath = path.join(root, '.refacil-pending-update');
   if (!fs.existsSync(flagPath)) return;
@@ -78,9 +80,9 @@ function notifyUpdate() {
     return;
   }
 
-  const fromLabel = info.from ? `v${info.from}` : 'version anterior';
+  const fromLabel = info.from ? `v${info.from}` : 'previous version';
 
-  // Si el usuario ya está ejecutando /refacil:update, dejar pasar y borrar el flag
+  // If the user is already running /refacil:update, let it through and clear the flag
   const prompt = readStdinPrompt();
   if (prompt.includes('refacil:update') || prompt.includes('refacil/update')) {
     try { fs.unlinkSync(flagPath); } catch (_) {}
@@ -88,13 +90,13 @@ function notifyUpdate() {
   }
 
   if (!info.shown) {
-    // Primera vez: bloquear para que el usuario lo vea claramente
+    // First time: block so the user sees it clearly
     try { fs.writeFileSync(flagPath, JSON.stringify({ ...info, shown: true })); } catch (_) {}
     const userMsg =
-      `[refacil-sdd-ai] Actualizacion de metodologia detectada (${fromLabel} → v${info.to}).\n` +
-      `Tu mensaje fue pausado. ¿Deseas aplicar las migraciones pendientes antes de continuar?\n` +
-      `  • Si: ejecuta /refacil:update\n` +
-      `  • No: reenvía tu mensaje anterior para continuar sin actualizar.`;
+      `[refacil-sdd-ai] Methodology update detected (${fromLabel} → v${info.to}).\n` +
+      `Your message was paused. Do you want to apply the pending migrations before continuing?\n` +
+      `  • Yes: run /refacil:update\n` +
+      `  • No: resend your previous message to continue without updating.`;
     if (isCursor) {
       process.stdout.write(JSON.stringify({ continue: false, user_message: userMsg }) + '\n');
     } else {
@@ -103,12 +105,12 @@ function notifyUpdate() {
     }
     process.exit(2);
   } else {
-    // Segunda vez: dejar pasar y avisar al LLM (solo Claude Code soporta inyectar contexto)
+    // Second time: let through and notify the LLM (only Claude Code supports context injection)
     try { fs.unlinkSync(flagPath); } catch (_) {}
     if (!isCursor) {
       console.log(
-        `[refacil-sdd-ai] IMPORTANTE: hay una actualizacion de la metodologia SDD-AI pendiente (${fromLabel} → v${info.to}). ` +
-        `Antes de responder al usuario, preguntale si desea ejecutar /refacil:update ahora.`,
+        `[refacil-sdd-ai] IMPORTANT: there is a pending SDD-AI methodology update (${fromLabel} → v${info.to}). ` +
+        `Before responding to the user, ask them if they want to run /refacil:update now.`,
       );
     }
   }
@@ -137,11 +139,11 @@ function syncRepoSkillsIfStale(globalVersion) {
   const repoVersion = readRepoVersion(projectRoot);
   if (repoVersion === globalVersion) return null;
 
-  // El repo tiene skills más nuevas que el paquete instalado — no degradar
+  // Repo has newer skills than the installed package — do not downgrade
   if (semverGt(repoVersion, globalVersion)) {
     process.stderr.write(
-      `[refacil-sdd-ai] El repo usa la metodologia v${repoVersion} pero el paquete global es v${globalVersion}. ` +
-      `Ejecuta: npm update -g refacil-sdd-ai\n`,
+      `[refacil-sdd-ai] Repo uses methodology v${repoVersion} but the global package is v${globalVersion}. ` +
+      `Run: npm update -g refacil-sdd-ai\n`,
     );
     return null;
   }
@@ -167,10 +169,10 @@ function migrationPendingCmd() {
   if (wantJson) {
     process.stdout.write(`${JSON.stringify({ pending, reasons })}\n`);
   } else if (pending) {
-    console.log('  Migraciones de metodologia pendientes:');
+    console.log('  Pending methodology migrations:');
     for (const r of reasons) console.log(`    - ${r}`);
   } else {
-    console.log('  Sin migraciones de metodologia pendientes (criterio alineado con hooks y /refacil:update).');
+    console.log('  No pending methodology migrations (criteria aligned with hooks and /refacil:update).');
   }
   clearStalePendingUpdateFlag(projectRoot);
   process.exit(pending ? 1 : 0);
@@ -179,18 +181,33 @@ function migrationPendingCmd() {
 function checkUpdate() {
   clearStalePendingUpdateFlag(projectRoot);
 
+  try {
+    autoMigrateOpenspec(projectRoot);
+  } catch (err) {
+    process.stderr.write(`[refacil-sdd-ai] Could not migrate openspec/ to refacil-sdd/: ${err.message}\n`);
+  }
+
+  try {
+    const legacyRemoved = removeOpenspecLegacyAssets(projectRoot);
+    if (legacyRemoved > 0) {
+      process.stderr.write(`[refacil-sdd-ai] Removed ${legacyRemoved} legacy OpenSpec assets (openspec-* skills, opsx-* commands)\n`);
+    }
+  } catch (err) {
+    process.stderr.write(`[refacil-sdd-ai] Could not remove legacy OpenSpec assets: ${err.message}\n`);
+  }
+
   const { execSync } = require('child_process');
   let localVersion = getPackageVersion(packageRoot);
 
   try {
     syncCompactGuidance(projectRoot, packageRoot);
   } catch (err) {
-    process.stderr.write(`[refacil-sdd-ai] No se pudo sincronizar compact-guidance: ${err.message}\n`);
+    process.stderr.write(`[refacil-sdd-ai] Could not sync compact-guidance: ${err.message}\n`);
   }
 
   cleanLegacySettingsHooks(projectRoot);
 
-  // Paso 1: actualizar el paquete global si hay version nueva en npm
+  // Step 1: update the global package if a newer version is available on npm
   try {
     const latest = execSync('npm view refacil-sdd-ai version', {
       encoding: 'utf8',
@@ -204,8 +221,8 @@ function checkUpdate() {
         localVersion = latest;
       } catch (_) {
         console.log(
-          `[refacil-sdd-ai] Hay una nueva version disponible (v${localVersion} -> v${latest}) pero la actualizacion automatica fallo. ` +
-          `Ejecuta manualmente: npm update -g refacil-sdd-ai && refacil-sdd-ai update`,
+          `[refacil-sdd-ai] A new version is available (v${localVersion} -> v${latest}) but the automatic update failed. ` +
+          `Run manually: npm update -g refacil-sdd-ai && refacil-sdd-ai update`,
         );
       }
     }
@@ -213,21 +230,21 @@ function checkUpdate() {
     // Silent: sin internet o registry no disponible
   }
 
-  // Paso 2: sincronizar skills del repo con el paquete (ya actualizado)
+  // Step 2: sync repo skills with the (now updated) package
   const syncResult = syncRepoSkillsIfStale(localVersion);
   if (syncResult && !syncResult.failed) {
-    const fromLabel = syncResult.from ? `v${syncResult.from}` : 'version desconocida';
+    const fromLabel = syncResult.from ? `v${syncResult.from}` : 'unknown version';
     console.log(
-      `[refacil-sdd-ai] Skills de este repo sincronizadas (${fromLabel} -> v${syncResult.to}). ` +
-      'Reinicia la sesion de Claude Code o Cursor para detectar los cambios.',
+      `[refacil-sdd-ai] Repo skills synced (${fromLabel} -> v${syncResult.to}). ` +
+      'Restart the Claude Code or Cursor session to pick up the changes.',
     );
     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}) ` +
-      'pero la sincronizacion automatica fallo. Ejecuta manualmente: refacil-sdd-ai update',
+      `[refacil-sdd-ai] Repo skills are out of date with the global package (v${syncResult.to}) ` +
+      'but automatic sync failed. Run manually: refacil-sdd-ai update',
     );
   }
 }
@@ -246,7 +263,9 @@ function checkReview() {
   const command = (input.tool_input && input.tool_input.command) || '';
   if (!command.match(/git\s+push/)) return;
 
-  const changesDir = path.join(projectRoot, 'openspec', 'changes');
+  const sddChangesDir = path.join(projectRoot, 'refacil-sdd', 'changes');
+  const legacyChangesDir = path.join(projectRoot, 'openspec', 'changes');
+  const changesDir = fs.existsSync(sddChangesDir) ? sddChangesDir : legacyChangesDir;
   if (!fs.existsSync(changesDir)) return;
 
   const entries = fs.readdirSync(changesDir, { withFileTypes: true });
@@ -264,14 +283,14 @@ function checkReview() {
     const names = missing.map((e) => e.name).join(', ');
     const reason =
       missing.length === 1
-        ? `[refacil-sdd-ai] Review pendiente para: ${names}. ` +
-          'Deten el push y ejecuta /refacil:review sobre ese cambio antes de subir codigo. ' +
-          'Si el review aprueba, reintenta el git push. ' +
-          'Si el review requiere correcciones, informa los hallazgos al usuario y NO reintentar el push.'
-        : `[refacil-sdd-ai] Hay multiples cambios sin review aprobado: ${names}. ` +
-          'Deten el push y pide al usuario seleccionar explicitamente que cambio quiere subir. ' +
-          'Luego ejecuta /refacil:review <nombre-cambio> para ese cambio especifico y reintenta el push. ' +
-          'No ejecutes review automatico sin seleccion cuando hay mas de un cambio pendiente.';
+        ? `[refacil-sdd-ai] Review pending for: ${names}. ` +
+          'Stop the push and run /refacil:review on that change before pushing code. ' +
+          'If the review passes, retry the git push. ' +
+          'If the review requires corrections, report the findings to the user and DO NOT retry the push.'
+        : `[refacil-sdd-ai] Multiple changes without approved review: ${names}. ` +
+          'Stop the push and ask the user to explicitly select which change they want to push. ' +
+          'Then run /refacil:review <change-name> for that specific change and retry the push. ' +
+          'Do not run automatic review without explicit selection when there is more than one pending change.';
     console.log(JSON.stringify({ decision: 'block', reason }));
   }
 }
@@ -279,7 +298,7 @@ function checkReview() {
 // --- High-level commands ---
 
 function init() {
-  console.log('\n  refacil-sdd-ai: Inicializando metodologia SDD-AI...\n');
+  console.log('\n  refacil-sdd-ai: Initializing SDD-AI methodology...\n');
 
   const nodeOk = checkNodeVersion();
   if (nodeOk) console.log(`  Node.js ${process.version} OK`);
@@ -288,18 +307,18 @@ function init() {
   if (claudeCheck.ok === true) {
     console.log(`  Claude Code ${claudeCheck.version} OK`);
   } else if (claudeCheck.ok === false) {
-    console.log(`\n  ADVERTENCIA: Claude Code ${claudeCheck.version} detectado.`);
-    console.log('  El hook compact-bash requiere Claude Code >= 2.1.89 para rewrite silencioso.');
-    console.log('  Con version inferior se instala igual pero el rewrite no tendra efecto.');
-    console.log('  Actualiza con: npm install -g @anthropic-ai/claude-code\n');
+    console.log(`\n  WARNING: Claude Code ${claudeCheck.version} detected.`);
+    console.log('  The compact-bash hook requires Claude Code >= 2.1.89 for silent rewrite.');
+    console.log('  It will still install on older versions but the rewrite will have no effect.');
+    console.log('  Update with: npm install -g @anthropic-ai/claude-code\n');
   }
 
   const count = installSkills(packageRoot, projectRoot);
-  console.log(`  ${count} skills instaladas en .claude/skills/ y .cursor/skills/`);
+  console.log(`  ${count} skills installed in .claude/skills/ and .cursor/skills/`);
 
   const agentsCount = installAgents(packageRoot, projectRoot);
   if (agentsCount > 0) {
-    console.log(`  ${agentsCount} sub-agentes instalados en .claude/agents/ y .cursor/agents/`);
+    console.log(`  ${agentsCount} sub-agents installed in .claude/agents/ and .cursor/agents/`);
   }
 
   writeRepoVersion(projectRoot, getPackageVersion(packageRoot));
@@ -308,56 +327,62 @@ function init() {
   if (createCursorRules(packageRoot, projectRoot)) console.log('  .cursorrules OK');
 
   if (installHooks('.claude', projectRoot)) {
-    console.log('  Hook check-update agregado a .claude/settings.json');
+    console.log('  Hook check-update added to .claude/settings.json');
   }
   if (installHooks('.cursor', projectRoot)) {
-    console.log('  Hook check-update agregado a .cursor/settings.json');
+    console.log('  Hook check-update added to .cursor/settings.json');
   }
 
   try {
     const ignoreResult = syncIgnoreFiles(projectRoot);
     const s = ignoreResult.claude;
     if (s.status === 'created') {
-      console.log('  .claudeignore y .cursorignore creados');
+      console.log('  .claudeignore and .cursorignore created');
     } else if (s.status === 'updated') {
-      console.log(`  .claudeignore y .cursorignore actualizados (${s.added} entradas agregadas)`);
+      console.log(`  .claudeignore and .cursorignore updated (${s.added} entries added)`);
     } else {
-      console.log('  .claudeignore y .cursorignore ya están al día');
+      console.log('  .claudeignore and .cursorignore are up to date');
     }
   } catch (err) {
-    console.error(`  Advertencia: no se pudo sincronizar ignore files: ${err.message}`);
+    console.error(`  Warning: could not sync ignore files: ${err.message}`);
   }
 
   try {
     const result = syncCompactGuidance(projectRoot, packageRoot);
     if (result.status === 'appended') {
-      console.log('  Bloque compact-guidance agregado a AGENTS.md');
+      console.log('  compact-guidance block added to AGENTS.md');
     } else if (result.status === 'replaced') {
-      console.log('  Bloque compact-guidance actualizado en AGENTS.md');
+      console.log('  compact-guidance block updated in AGENTS.md');
     }
   } catch (err) {
-    console.error(`  Advertencia: no se pudo sincronizar compact-guidance: ${err.message}`);
+    console.error(`  Warning: could not sync compact-guidance: ${err.message}`);
   }
 
-  console.log('\n  Siguientes pasos:\n');
-  console.log('  1. REINICIA tu sesion de Claude Code o Cursor');
-  console.log('     (las skills nuevas no se detectan hasta reiniciar)\n');
-  console.log('  2. Ejecuta: /refacil:setup');
-  console.log('     (instala OpenSpec y genera AGENTS.md para tu proyecto)\n');
-  console.log('  Nota: /refacil:setup tambien instalara los comandos de OpenSpec (opsx:*).');
-  console.log('  Los comandos refacil:* y opsx:* coexisten sin conflicto.');
-  console.log('  El equipo debe usar los refacil:* como interfaz principal.\n');
+  console.log('\n  Next steps:\n');
+  console.log('  1. RESTART your Claude Code or Cursor session');
+  console.log('     (new skills are not detected until the session is restarted)\n');
+  console.log('  2. Run: /refacil:setup');
+  console.log('     (generates AGENTS.md for your project)\n');
 }
 
 function update() {
-  console.log('\n  refacil-sdd-ai: Actualizando skills...\n');
+  console.log('\n  refacil-sdd-ai: Updating skills...\n');
 
   const count = installSkills(packageRoot, projectRoot);
-  console.log(`  ${count} skills actualizadas en .claude/skills/ y .cursor/skills/`);
+  console.log(`  ${count} skills updated in .claude/skills/ and .cursor/skills/`);
 
   const agentsCount = installAgents(packageRoot, projectRoot);
   if (agentsCount > 0) {
-    console.log(`  ${agentsCount} sub-agentes actualizados en .claude/agents/ y .cursor/agents/`);
+    console.log(`  ${agentsCount} sub-agents updated in .claude/agents/ and .cursor/agents/`);
+  }
+
+  try {
+    const legacyRemoved = removeOpenspecLegacyAssets(projectRoot);
+    if (legacyRemoved > 0) {
+      console.log(`  ${legacyRemoved} legacy OpenSpec assets removed (openspec-* skills, opsx-* commands)`);
+    }
+  } catch (err) {
+    process.stderr.write(`[refacil-sdd-ai] Could not remove legacy OpenSpec assets: ${err.message}\n`);
   }
 
   writeRepoVersion(projectRoot, getPackageVersion(packageRoot));
@@ -366,92 +391,93 @@ function update() {
   createCursorRules(packageRoot, projectRoot);
 
   if (installHooks('.claude', projectRoot)) {
-    console.log('  Hook check-update agregado a .claude/settings.json');
+    console.log('  Hook check-update added to .claude/settings.json');
   }
   if (installHooks('.cursor', projectRoot)) {
-    console.log('  Hook check-update agregado a .cursor/settings.json');
+    console.log('  Hook check-update added to .cursor/settings.json');
   }
 
   try {
     const ignoreResult = syncIgnoreFiles(projectRoot);
     const s = ignoreResult.claude;
     if (s.status === 'created') {
-      console.log('  .claudeignore y .cursorignore creados');
+      console.log('  .claudeignore and .cursorignore created');
     } else if (s.status === 'updated') {
-      console.log(`  .claudeignore y .cursorignore actualizados (${s.added} entradas agregadas)`);
+      console.log(`  .claudeignore and .cursorignore updated (${s.added} entries added)`);
     } else {
-      console.log('  .claudeignore y .cursorignore ya están al día');
+      console.log('  .claudeignore and .cursorignore are up to date');
     }
   } catch (err) {
-    console.error(`  Advertencia: no se pudo sincronizar ignore files: ${err.message}`);
+    console.error(`  Warning: could not sync ignore files: ${err.message}`);
   }
 
   try {
     const result = syncCompactGuidance(projectRoot, packageRoot);
     if (result.status === 'appended') {
-      console.log('  Bloque compact-guidance agregado a AGENTS.md');
+      console.log('  compact-guidance block added to AGENTS.md');
     } else if (result.status === 'replaced') {
-      console.log('  Bloque compact-guidance actualizado en AGENTS.md');
+      console.log('  compact-guidance block updated in AGENTS.md');
     }
   } catch (err) {
-    console.error(`  Advertencia: no se pudo sincronizar compact-guidance: ${err.message}`);
+    console.error(`  Warning: could not sync compact-guidance: ${err.message}`);
   }
 
-  console.log('\n  REINICIA tu sesion de Claude Code o Cursor para aplicar los cambios.\n');
+  console.log('\n  RESTART your Claude Code or Cursor session to apply the changes.\n');
 }
 
 function clean() {
-  console.log('\n  refacil-sdd-ai: Eliminando skills...\n');
+  console.log('\n  refacil-sdd-ai: Removing skills...\n');
 
   const count = removeSkills(projectRoot);
-  console.log(`  ${count} skills eliminadas de .claude/skills/ y .cursor/skills/`);
+  console.log(`  ${count} skills removed from .claude/skills/ and .cursor/skills/`);
 
   if (uninstallHooks('.claude', projectRoot)) {
-    console.log('  Hooks SDD-AI removidos de .claude/settings.json');
+    console.log('  SDD-AI hooks removed from .claude/settings.json');
   } else {
-    console.log('  No se encontraron hooks SDD-AI para remover en .claude/settings.json.');
+    console.log('  No SDD-AI hooks found to remove in .claude/settings.json.');
   }
   if (uninstallHooks('.cursor', projectRoot)) {
-    console.log('  Hooks SDD-AI removidos de .cursor/settings.json');
+    console.log('  SDD-AI hooks removed from .cursor/settings.json');
   }
 
   try {
     const result = removeCompactGuidance(projectRoot);
     if (result.status === 'removed') {
-      console.log('  Bloque compact-guidance removido de AGENTS.md');
+      console.log('  compact-guidance block removed from AGENTS.md');
     }
   } catch (err) {
-    console.error(`  Advertencia: no se pudo limpiar compact-guidance: ${err.message}`);
+    console.error(`  Warning: could not clean compact-guidance: ${err.message}`);
   }
 
-  console.log('  AGENTS.md, CLAUDE.md y .cursorrules no fueron eliminados.');
-  console.log('\n  Nota: Los comandos opsx:* de OpenSpec no se eliminan.');
-  console.log('  Para eliminar OpenSpec: rm -rf openspec/ .claude/commands/opsx .cursor/commands/opsx\n');
+  console.log('  AGENTS.md, CLAUDE.md and .cursorrules were not removed.');
+  console.log('\n  Note: if you have openspec/ in the repo, migrate first with: refacil-sdd-ai sdd status');
+  console.log('  (the openspec/ → refacil-sdd/ migration is automatic on any sdd subcommand)');
+  console.log('  To remove the openspec/ directory after migrating: rm -rf openspec/\n');
 }
 
 function help() {
   console.log(`
-  refacil-sdd-ai — Metodologia SDD-AI con OpenSpec
-
-  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 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:
-                    compact stats      - Estadisticas completas (hook + ya-compacto) y ahorro estimado
-                    compact disable    - Desactiva el rewrite temporalmente
-                    compact enable     - Re-activa el rewrite
-                    compact clear-log  - Borra el log historico
-    bus           Subcomandos del chat room entre agentes (refacil-bus):
-                    bus start          - Arranca el broker local (auto-spawn detached)
-                    bus stop           - Detiene el broker
-                    bus status         - Muestra puerto, pid, uptime del broker
-                    bus serve          - (interno) Ejecuta el broker en foreground
-                    bus join --room <sala> [--session <s>] [--intro "..."]
+  refacil-sdd-ai — SDD-AI Methodology
+
+  Commands:
+    init          Install skills in .claude/ and .cursor/, create CLAUDE.md and .cursorrules
+    update        Re-copy skills (to update to a new package version)
+    migration-pending  Same validation as hooks/notify-update: list migrations (exit 1 if any; --json)
+    check-update   Sync skills and compact-guidance at session start (SessionStart hook)
+    notify-update  Notify methodology migration only if applicable (UserPromptSubmit hook)
+    check-review   Verify that review has been completed (used by PreToolUse hook)
+    compact-bash  Rewrite bare Bash commands to reduce tokens (used by PreToolUse hook)
+    compact       Subcommands for the compact-bash hook:
+                    compact stats      - Full stats (hook + already-compact) and estimated savings
+                    compact disable    - Temporarily disable rewrite
+                    compact enable     - Re-enable rewrite
+                    compact clear-log  - Clear the history log
+    bus           Subcommands for the inter-agent chat room (refacil-bus):
+                    bus start          - Start the local broker (auto-spawn detached)
+                    bus stop           - Stop the broker
+                    bus status         - Show port, pid, uptime of the broker
+                    bus serve          - (internal) Run the broker in foreground
+                    bus join --room <room> [--session <s>] [--intro "..."]
                     bus leave [--session <s>]
                     bus say --text "..." [--session <s>]
                     bus ask --to <name|all|*|everyone> --text "..." [--wait N] [--session <s>]
@@ -459,21 +485,29 @@ function help() {
                     bus history [--n N] [--session <s>]
                     bus inbox [--session <s>]
                     bus rooms
-                    bus watch <session> [--room <sala>]  (panel en vivo, sin tokens)
-                    bus attend [--timeout N]             (escucha preguntas dirigidas)
-                    bus view                             (abre la UI web en el navegador)
-    clean         Elimina skills y remueve hooks SDD-AI de .claude/settings.json y .cursor/settings.json
-    help          Muestra esta ayuda
-
-  Flujo completo:
+                    bus watch <session> [--room <room>]  (live panel, no tokens)
+                    bus attend [--timeout N]             (listen for directed questions)
+                    bus view                             (open the web UI in the browser)
+    sdd           Subcommands for managing SDD-AI artifacts in refacil-sdd/:
+                    sdd new-change <name>         Create a change with proposal/design/tasks/specs scaffold
+                    sdd archive <name>             Archive a change to refacil-sdd/changes/archive/
+                    sdd list [--json]              List active changes with review status
+                    sdd status <name> [--json]     Artifact and task status of a change
+                    sdd mark-reviewed <name>       Write .review-passed (requires --verdict and --summary)
+                    sdd tasks-update <name>        Mark task N as completed (--task N --done)
+                    sdd validate-name <name>       Validate change name format
+    clean         Remove skills and SDD-AI hooks from .claude/settings.json and .cursor/settings.json
+    help          Show this help
+
+  Full flow:
     1. npm install -g refacil-sdd-ai
     2. refacil-sdd-ai init
-    3. REINICIAR sesion de Claude Code o Cursor
-    4. Ejecutar: /refacil:setup (instala OpenSpec + genera AGENTS.md)
+    3. RESTART the Claude Code or Cursor session
+    4. Run: /refacil:setup (generates AGENTS.md for your project)
 
-  Requisitos:
-    - Node.js >= 20.19.0 (requerido por OpenSpec)
-    - Claude Code >= 2.1.89 (requerido por compact-bash para rewrite silencioso) o Cursor
+  Requirements:
+    - Node.js >= 20.19.0
+    - Claude Code >= 2.1.89 (required by compact-bash for silent rewrite) or Cursor
   `);
 }
 
@@ -481,6 +515,11 @@ function help() {
 
 const command = process.argv[2] || 'help';
 
+if (command === '--version' || command === '-v') {
+  console.log(getPackageVersion(packageRoot));
+  process.exit(0);
+}
+
 switch (command) {
   case 'init':
     init();
@@ -509,6 +548,9 @@ switch (command) {
   case 'bus':
     handleBus(process.argv[3], process.argv.slice(4), packageRoot);
     break;
+  case 'sdd':
+    handleSdd(process.argv[3], process.argv.slice(4));
+    break;
   case 'clean':
     clean();
     break;
@@ -518,7 +560,7 @@ switch (command) {
     help();
     break;
   default:
-    console.error(`  Comando desconocido: ${command}`);
+    console.error(`  Unknown command: ${command}`);
     help();
     process.exit(1);
 }

package/lib/bus/askFulfillment.js

@@ -1,17 +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 };
+'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 };