refacil-sdd-ai 3.0.2 → 3.1.0

package/bin/cli.js

@@ -1,1407 +1,400 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
-const {
-  syncCompactGuidance,
-  removeCompactGuidance,
-} = require('../lib/compact-guidance');
-const compactBash = require('../lib/compact/bash');
-const compactTelemetry = require('../lib/compact/telemetry');
-const busBroker = require('../lib/bus/broker');
-const busSpawn = require('../lib/bus/spawn');
-const busClient = require('../lib/bus/client');
-const busWatch = require('../lib/bus/watch');
-const busPresenter = require('../lib/bus/presenter');
-
-const SKILLS = [
-  'setup',
-  'prereqs',
-  'guide',
-  'explore',
-  'propose',
-  'apply',
-  'test',
-  'verify',
-  'review',
-  'archive',
-  'bug',
-  'up-code',
-  // refacil-bus (agent chat room)
-  'join',
-  'say',
-  'ask',
-  'reply',
-  'inbox',
-  'attend',
-];
-
-// Sub-agentes instalados en .claude/agents/ y .cursor/agents/.
-// Fuente: refacil-sdd-ai/agents/<name>.md (un solo archivo, frontmatter estilo Claude Code).
-// El installer lo copia verbatim a Claude y transforma el frontmatter para Cursor.
-const AGENTS = [
-  'auditor',
-  'investigator',
-  'validator',
-];
-
-const packageRoot = path.resolve(__dirname, '..');
-const projectRoot = process.cwd();
-
-function copyDir(src, dest) {
-  fs.mkdirSync(dest, { recursive: true });
-  const entries = fs.readdirSync(src, { withFileTypes: true });
-  for (const entry of entries) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    if (entry.isDirectory()) {
-      copyDir(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
-
-function installSkills() {
-  let installed = 0;
-
-  for (const skill of SKILLS) {
-    const srcDir = path.join(packageRoot, 'skills', skill);
-    if (!fs.existsSync(srcDir)) continue;
-
-    // Copy to .claude/skills/
-    const claudeDest = path.join(projectRoot, '.claude', 'skills', `refacil-${skill}`);
-    copyDir(srcDir, claudeDest);
-
-    // Copy to .cursor/skills/
-    const cursorDest = path.join(projectRoot, '.cursor', 'skills', `refacil-${skill}`);
-    copyDir(srcDir, cursorDest);
-
-    installed++;
-  }
-
-  return installed;
-}
-
-// Transforma el frontmatter de un sub-agente Claude Code al formato Cursor.
-// Claude Code: `tools:` (allowlist granular), `model: sonnet|opus|haiku`
-// Cursor: `readonly: true|false` (booleano), `model: inherit` (default).
-//
-// Reglas:
-// - Si tools NO incluye Edit ni Write → readonly: true (reviewer-style, read-only).
-// - Si tools SI incluye Edit o Write → readonly: false.
-// - model: sonnet|opus|haiku → model: inherit (Cursor decide).
-// - model: <id explicito tipo claude-sonnet-4-6> → se mantiene.
-// - Body (todo despues del segundo ---) se preserva verbatim.
-function transformFrontmatterForCursor(content) {
-  const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
-  if (!match) return content; // sin frontmatter reconocible, copiamos tal cual
-
-  const [, frontmatterRaw, body] = match;
-  const lines = frontmatterRaw.split('\n');
-  const out = [];
-  let toolsLine = null;
-  let hasReadonly = false;
-
-  for (const line of lines) {
-    if (line.startsWith('tools:')) {
-      toolsLine = line;
-      continue; // se omite: Cursor no lo entiende
-    }
-    if (line.startsWith('readonly:')) {
-      hasReadonly = true;
-      out.push(line);
-      continue;
-    }
-    if (line.startsWith('model:')) {
-      const value = line.slice('model:'.length).trim();
-      if (value === 'sonnet' || value === 'opus' || value === 'haiku') {
-        out.push('model: inherit');
-      } else {
-        out.push(line);
-      }
-      continue;
-    }
-    out.push(line);
-  }
-
-  // Si el agente declaraba tools explicito y no tenia readonly,
-  // inferimos readonly a partir de tools.
-  if (toolsLine && !hasReadonly) {
-    const toolsList = toolsLine.slice('tools:'.length).trim();
-    const canWrite = /\b(Edit|Write|NotebookEdit)\b/.test(toolsList);
-    out.push(`readonly: ${canWrite ? 'false' : 'true'}`);
-  }
-
-  return `---\n${out.join('\n')}\n---\n${body}`;
-}
-
-function installAgents() {
-  let installed = 0;
-
-  const claudeDir = path.join(projectRoot, '.claude', 'agents');
-  const cursorDir = path.join(projectRoot, '.cursor', 'agents');
-  fs.mkdirSync(claudeDir, { recursive: true });
-  fs.mkdirSync(cursorDir, { recursive: true });
-
-  for (const agent of AGENTS) {
-    const srcFile = path.join(packageRoot, 'agents', `${agent}.md`);
-    if (!fs.existsSync(srcFile)) continue;
-
-    const content = fs.readFileSync(srcFile, 'utf8');
-
-    // Claude Code: copia verbatim
-    const claudeDest = path.join(claudeDir, `refacil-${agent}.md`);
-    fs.writeFileSync(claudeDest, content);
-
-    // Cursor: transforma frontmatter
-    const cursorDest = path.join(cursorDir, `refacil-${agent}.md`);
-    fs.writeFileSync(cursorDest, transformFrontmatterForCursor(content));
-
-    installed++;
-  }
-
-  return installed;
-}
-
-const SDD_SECTION_MARKER = '## Metodologia SDD-AI (Refacil)';
-
-function extractSddSection(templateContent) {
-  const idx = templateContent.indexOf(SDD_SECTION_MARKER);
-  if (idx === -1) return templateContent;
-  return templateContent.substring(idx);
-}
-
-function readMethodologyGuide() {
-  return fs.readFileSync(
-    path.join(packageRoot, 'templates', 'methodology-guide.md'),
-    'utf8',
-  );
-}
-
-function writeGuideFile(destPath, header, label) {
-  const guide = readMethodologyGuide();
-  const content = `# ${header}\n\n${guide}`;
-
-  if (fs.existsSync(destPath)) {
-    const existing = fs.readFileSync(destPath, 'utf8');
-    if (existing.includes(SDD_SECTION_MARKER)) {
-      console.log(`  ${label} ya tiene la seccion SDD-AI. Sin cambios.`);
-      return false;
-    }
-    const sddSection = extractSddSection(guide);
-    fs.writeFileSync(destPath, existing.trimEnd() + '\n\n' + sddSection + '\n');
-    console.log(`  ${label} existente — seccion SDD-AI agregada al final.`);
-    return true;
-  }
-
-  fs.writeFileSync(destPath, content);
-  return true;
-}
-
-function createClaudeMd() {
-  return writeGuideFile(
-    path.join(projectRoot, 'CLAUDE.md'),
-    'CLAUDE.md',
-    'CLAUDE.md',
-  );
-}
-
-function createCursorRules() {
-  return writeGuideFile(
-    path.join(projectRoot, '.cursorrules'),
-    'Cursor Rules',
-    '.cursorrules',
-  );
-}
-
-const REPO_VERSION_FILES = ['.claude/.sdd-version', '.cursor/.sdd-version'];
-
-function readRepoVersion(rootDir) {
-  for (const rel of REPO_VERSION_FILES) {
-    const p = path.join(rootDir, rel);
-    try {
-      const raw = fs.readFileSync(p, 'utf8').trim();
-      if (raw) return raw;
-    } catch (_) {
-      // continuar al siguiente
-    }
-  }
-  return null;
-}
-
-function writeRepoVersion(rootDir, version) {
-  for (const rel of REPO_VERSION_FILES) {
-    const p = path.join(rootDir, rel);
-    const parent = path.dirname(p);
-    if (!fs.existsSync(parent)) continue;
-    try {
-      fs.writeFileSync(p, String(version) + '\n');
-    } catch (_) {
-      // tolerante
-    }
-  }
-}
-
-function getPackageVersion() {
-  try {
-    return require(path.join(packageRoot, 'package.json')).version;
-  } catch (_) {
-    return null;
-  }
-}
-
-function removeSkills() {
-  let removed = 0;
-  for (const skill of SKILLS) {
-    const claudeDir = path.join(projectRoot, '.claude', 'skills', `refacil-${skill}`);
-    const cursorDir = path.join(projectRoot, '.cursor', 'skills', `refacil-${skill}`);
-
-    if (fs.existsSync(claudeDir)) {
-      fs.rmSync(claudeDir, { recursive: true });
-      removed++;
-    }
-    if (fs.existsSync(cursorDir)) {
-      fs.rmSync(cursorDir, { recursive: true });
-    }
-  }
-  return removed;
-}
-
-function checkClaudeCodeVersion() {
-  const { execSync } = require('child_process');
-  try {
-    const output = execSync('claude --version 2>&1', {
-      encoding: 'utf8',
-      timeout: 5000,
-      stdio: ['pipe', 'pipe', 'pipe'],
-    }).trim();
-    const match = output.match(/(\d+)\.(\d+)\.(\d+)/);
-    if (!match) return { ok: null, version: null };
-    const maj = Number(match[1]);
-    const min = Number(match[2]);
-    const patch = Number(match[3]);
-    const ok =
-      maj > 2 ||
-      (maj === 2 && min > 1) ||
-      (maj === 2 && min === 1 && patch >= 89);
-    return { ok, version: `${maj}.${min}.${patch}` };
-  } catch (_) {
-    return { ok: null, version: null };
-  }
-}
-
-function checkNodeVersion() {
-  const version = process.version; // e.g. v20.19.5
-  const major = parseInt(version.split('.')[0].replace('v', ''));
-  const minor = parseInt(version.split('.')[1]);
-
-  if (major < 20 || (major === 20 && minor < 19)) {
-    console.log(`\n  ADVERTENCIA: Node.js ${version} detectado.`);
-    console.log('  OpenSpec requiere Node.js >= 20.19.0.');
-    console.log('  Las skills se instalaran pero /refacil:setup podria fallar al instalar OpenSpec.\n');
-    return false;
-  }
-  return true;
-}
-
-// --- Hook installation ---
-
-function installHook() {
-  const settingsDir = path.join(projectRoot, '.claude');
-  const settingsPath = path.join(settingsDir, 'settings.json');
-  let settings = {};
-
-  if (fs.existsSync(settingsPath)) {
-    settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
-  }
-
-  if (!settings.hooks) settings.hooks = {};
-  if (!settings.hooks.SessionStart) settings.hooks.SessionStart = [];
-
-  let changed = false;
-
-  // SessionStart: check-update
-  const hasUpdateHook = settings.hooks.SessionStart.some(h => h._sdd === true);
-  if (!hasUpdateHook) {
-    settings.hooks.SessionStart.push({
-      _sdd: true,
-      matcher: '',
-      hooks: [
-        {
-          type: 'command',
-          command: 'refacil-sdd-ai check-update',
-        },
-      ],
-    });
-    changed = true;
-  }
-
-  // PreToolUse
-  if (!settings.hooks.PreToolUse) settings.hooks.PreToolUse = [];
-
-  // compact-bash (must run BEFORE check-review so rewrite is visible to subsequent hooks)
-  const hasCompactHook = settings.hooks.PreToolUse.some(
-    (h) => h._sdd_compact === true,
-  );
-  if (!hasCompactHook) {
-    settings.hooks.PreToolUse.unshift({
-      _sdd_compact: true,
-      matcher: 'Bash',
-      hooks: [
-        {
-          type: 'command',
-          command: 'refacil-sdd-ai compact-bash',
-        },
-      ],
-    });
-    changed = true;
-  }
-
-  // check-review
-  const hasReviewHook = settings.hooks.PreToolUse.some(
-    (h) => h._sdd_review === true,
-  );
-  if (!hasReviewHook) {
-    settings.hooks.PreToolUse.push({
-      _sdd_review: true,
-      matcher: 'Bash',
-      hooks: [
-        {
-          type: 'command',
-          command: 'refacil-sdd-ai check-review',
-        },
-      ],
-    });
-    changed = true;
-  }
-
-  if (!changed) {
-    console.log('  Hooks SDD-AI ya configurados.');
-    return false;
-  }
-
-  fs.mkdirSync(settingsDir, { recursive: true });
-  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
-  return true;
-}
-
-function uninstallHook() {
-  const settingsPath = path.join(projectRoot, '.claude', 'settings.json');
-  if (!fs.existsSync(settingsPath)) return false;
-
-  let settings;
-  try {
-    settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
-  } catch (_) {
-    console.log('  No se pudieron remover hooks: .claude/settings.json invalido.');
-    return false;
-  }
-
-  if (!settings.hooks) return false;
-
-  let changed = false;
-
-  if (Array.isArray(settings.hooks.SessionStart)) {
-    const original = settings.hooks.SessionStart.length;
-    settings.hooks.SessionStart = settings.hooks.SessionStart.filter(
-      (h) => h._sdd !== true,
-    );
-    if (settings.hooks.SessionStart.length !== original) changed = true;
-    if (settings.hooks.SessionStart.length === 0) delete settings.hooks.SessionStart;
-  }
-
-  if (Array.isArray(settings.hooks.PreToolUse)) {
-    const original = settings.hooks.PreToolUse.length;
-    settings.hooks.PreToolUse = settings.hooks.PreToolUse.filter(
-      (h) => h._sdd_review !== true && h._sdd_compact !== true,
-    );
-    if (settings.hooks.PreToolUse.length !== original) changed = true;
-    if (settings.hooks.PreToolUse.length === 0) delete settings.hooks.PreToolUse;
-  }
-
-  if (Object.keys(settings.hooks).length === 0) delete settings.hooks;
-
-  if (!changed) return false;
-
-  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
-  return true;
-}
-
-// --- Check update ---
-
-function repoIsInitialized() {
-  return (
-    fs.existsSync(path.join(projectRoot, '.claude', 'skills')) ||
-    fs.existsSync(path.join(projectRoot, '.cursor', 'skills'))
-  );
-}
-
-function syncRepoSkillsIfStale(globalVersion) {
-  // Si el paquete global ya está en globalVersion pero este repo tiene skills
-  // de una versión anterior (porque otro repo disparó el auto-upgrade), hay
-  // que re-copiarlas aquí. Idem si nunca se marcó la versión en este repo.
-  if (!repoIsInitialized()) return null;
-  const repoVersion = readRepoVersion(projectRoot);
-  if (repoVersion === globalVersion) return null;
-
-  const { execSync } = require('child_process');
-  const localCli = path.join(packageRoot, 'bin', 'cli.js');
-  try {
-    execSync(`"${process.execPath}" "${localCli}" update`, {
-      encoding: 'utf8',
-      timeout: 30000,
-      stdio: ['pipe', 'pipe', 'pipe'],
-    });
-    writeRepoVersion(projectRoot, globalVersion);
-    return { from: repoVersion, to: globalVersion };
-  } catch (_) {
-    return { from: repoVersion, to: globalVersion, failed: true };
-  }
-}
-
-function checkUpdate() {
-  const { execSync } = require('child_process');
-  const localVersion = getPackageVersion();
-
-  // Always ensure AGENTS.md has current compact-guidance block (silent unless error)
-  try {
-    syncCompactGuidance(projectRoot, packageRoot);
-  } catch (err) {
-    process.stderr.write(
-      `[refacil-sdd-ai] No se pudo sincronizar compact-guidance: ${err.message}\n`,
-    );
-  }
-
-  // Paso 1: sincronizar skills del repo actual si quedaron desfasadas respecto
-  // al paquete global (pasa cuando otro repo ya disparó el auto-upgrade).
-  const syncResult = syncRepoSkillsIfStale(localVersion);
-  if (syncResult && !syncResult.failed) {
-    const fromLabel = syncResult.from ? `v${syncResult.from}` : 'version desconocida';
-    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.',
-    );
-  } 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',
-    );
-  }
-
-  // Paso 2: chequear si hay version nueva en npm y, si la hay, actualizar
-  // global + copiar skills al repo actual.
-  try {
-    const latest = execSync('npm view refacil-sdd-ai version', {
-      encoding: 'utf8',
-      timeout: 10000,
-      stdio: ['pipe', 'pipe', 'pipe'],
-    }).trim();
-
-    if (!latest || latest === localVersion) return;
-
-    try {
-      execSync('npm update -g refacil-sdd-ai', {
-        encoding: 'utf8',
-        timeout: 60000,
-        stdio: ['pipe', 'pipe', 'pipe'],
-      });
-      execSync('refacil-sdd-ai update', {
-        encoding: 'utf8',
-        timeout: 30000,
-        stdio: ['pipe', 'pipe', 'pipe'],
-      });
-      writeRepoVersion(projectRoot, latest);
-      console.log(
-        `[refacil-sdd-ai] La metodologia SDD-AI se actualizo automaticamente de v${localVersion} a v${latest}. Skills y hooks sincronizados.`,
-      );
-    } catch (_) {
-      console.log(
-        `[refacil-sdd-ai] Hay una nueva version disponible (v${localVersion} -> v${latest}) pero la actualizacion automatica fallo. ` +
-        `Informa al usuario que ejecute manualmente: npm update -g refacil-sdd-ai && refacil-sdd-ai update`,
-      );
-    }
-  } catch (_) {
-    // Silent on error (no internet, registry unreachable, etc.)
-  }
-}
-
-// --- Check review (PreToolUse hook) ---
-
-function checkReview() {
-  // Read stdin (JSON from PreToolUse hook)
-  let input;
-  try {
-    const stdin = fs.readFileSync(0, 'utf8');
-    input = JSON.parse(stdin);
-  } catch (_) {
-    // If no stdin or invalid JSON, allow (not called from hook context)
-    return;
-  }
-
-  // Only block git push commands
-  const command = (input.tool_input && input.tool_input.command) || '';
-  if (!command.match(/git\s+push/)) return;
-
-  // Find active change in openspec/changes/ (exclude archive/)
-  const changesDir = path.join(projectRoot, 'openspec', 'changes');
-  if (!fs.existsSync(changesDir)) return; // No openspec, allow
-
-  const entries = fs.readdirSync(changesDir, { withFileTypes: true });
-  const activeChanges = entries.filter(
-    (e) => e.isDirectory() && e.name !== 'archive',
-  );
-
-  if (activeChanges.length === 0) return; // No active changes, allow
-
-  // Check if any active change is missing .review-passed
-  const missing = activeChanges.filter(
-    (e) => !fs.existsSync(path.join(changesDir, e.name, '.review-passed')),
-  );
-
-  if (missing.length > 0) {
-    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.';
-    console.log(
-      JSON.stringify({
-        decision: 'block',
-        reason,
-      }),
-    );
-  }
-}
-
-// --- Commands ---
-
-function init() {
-  console.log('\n  refacil-sdd-ai: Inicializando metodologia SDD-AI...\n');
-
-  // Check Node version
-  const nodeOk = checkNodeVersion();
-  if (nodeOk) {
-    console.log(`  Node.js ${process.version} OK`);
-  }
-
-  // Check Claude Code version (for compact-bash hook)
-  const claudeCheck = checkClaudeCodeVersion();
-  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');
-  }
-  // ok === null: claude no esta en PATH, silencioso
-
-  // Install skills
-  const count = installSkills();
-  console.log(`  ${count} skills instaladas en .claude/skills/ y .cursor/skills/`);
-
-  // Install sub-agents
-  const agentsCount = installAgents();
-  if (agentsCount > 0) {
-    console.log(`  ${agentsCount} sub-agentes instalados en .claude/agents/ y .cursor/agents/`);
-  }
-
-  writeRepoVersion(projectRoot, getPackageVersion());
-
-  // Create or update CLAUDE.md
-  if (createClaudeMd()) {
-    console.log('  CLAUDE.md OK');
-  }
-
-  // Create or update .cursorrules
-  if (createCursorRules()) {
-    console.log('  .cursorrules OK');
-  }
-
-  // Install SessionStart hook for version check
-  if (installHook()) {
-    console.log('  Hook check-update agregado a .claude/settings.json');
-  }
-
-  // Sync compact-guidance block in AGENTS.md (if it exists)
-  try {
-    const result = syncCompactGuidance(projectRoot, packageRoot);
-    if (result.status === 'appended') {
-      console.log('  Bloque compact-guidance agregado a AGENTS.md');
-    } else if (result.status === 'replaced') {
-      console.log('  Bloque compact-guidance actualizado en AGENTS.md');
-    }
-  } catch (err) {
-    console.error(`  Advertencia: no se pudo sincronizar 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');
-}
-
-function update() {
-  console.log('\n  refacil-sdd-ai: Actualizando skills...\n');
-  const count = installSkills();
-  console.log(`  ${count} skills actualizadas en .claude/skills/ y .cursor/skills/`);
-
-  const agentsCount = installAgents();
-  if (agentsCount > 0) {
-    console.log(`  ${agentsCount} sub-agentes actualizados en .claude/agents/ y .cursor/agents/`);
-  }
-
-  writeRepoVersion(projectRoot, getPackageVersion());
-
-  // Ensure hook is installed (for users updating from versions without hook)
-  if (installHook()) {
-    console.log('  Hook check-update agregado a .claude/settings.json');
-  }
-
-  // Sync compact-guidance block in AGENTS.md
-  try {
-    const result = syncCompactGuidance(projectRoot, packageRoot);
-    if (result.status === 'appended') {
-      console.log('  Bloque compact-guidance agregado a AGENTS.md');
-    } else if (result.status === 'replaced') {
-      console.log('  Bloque compact-guidance actualizado en AGENTS.md');
-    }
-  } catch (err) {
-    console.error(`  Advertencia: no se pudo sincronizar compact-guidance: ${err.message}`);
-  }
-
-  console.log('\n  REINICIA tu sesion de Claude Code o Cursor para aplicar los cambios.\n');
-}
-
-function clean() {
-  console.log('\n  refacil-sdd-ai: Eliminando skills...\n');
-  const count = removeSkills();
-  console.log(`  ${count} skills eliminadas de .claude/skills/ y .cursor/skills/`);
-  if (uninstallHook()) {
-    console.log('  Hooks SDD-AI removidos de .claude/settings.json');
-  } else {
-    console.log('  No se encontraron hooks SDD-AI para remover.');
-  }
-
-  // Remove compact-guidance block from AGENTS.md if present
-  try {
-    const result = removeCompactGuidance(projectRoot);
-    if (result.status === 'removed') {
-      console.log('  Bloque compact-guidance removido de AGENTS.md');
-    }
-  } catch (err) {
-    console.error(`  Advertencia: no se pudo limpiar 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');
-}
-
-// --- Compact subcommands (stats / enable / disable / clear-log) ---
-
-function handleCompactSubcommand(sub) {
-  switch (sub) {
-    case 'stats':
-      showCompactStats();
-      break;
-    case 'disable':
-      compactTelemetry.disable();
-      console.log('  compact-bash deshabilitado. Reactiva con: refacil-sdd-ai compact enable');
-      break;
-    case 'enable':
-      compactTelemetry.enable();
-      console.log('  compact-bash habilitado.');
-      break;
-    case 'clear-log':
-      compactTelemetry.clearLog();
-      console.log('  compact.log limpiado.');
-      break;
-    default:
-      console.log('Uso: refacil-sdd-ai compact <stats|disable|enable|clear-log>');
-  }
-}
-
-function showCompactStats() {
-  const s = compactTelemetry.stats();
-  if (s.totalEvents === 0) {
-    console.log('\n  No hay eventos registrados todavia. Ejecuta comandos Bash para generar telemetria de compactacion.\n');
-    return;
-  }
-
-  const sortedRewrites = Object.entries(s.byRule)
-    .filter(([, data]) => data.rewriteCount > 0)
-    .sort((a, b) => b[1].rewriteSaved - a[1].rewriteSaved);
-  const sortedAlreadyCompact = Object.entries(s.byRule)
-    .filter(([, data]) => data.alreadyCompactCount > 0)
-    .sort((a, b) => b[1].alreadyCompactPotential - a[1].alreadyCompactPotential);
-
-  console.log(`\n  compact-bash stats\n`);
-  console.log(`  Rewrites por hook: ${s.totalRewrites}`);
-  console.log(`  Comandos ya compactos detectados (skill/agente): ${s.totalAlreadyCompact}\n`);
-
-  if (sortedRewrites.length > 0) {
-    console.log('  Ahorro aplicado por hook (rewrite):');
-    for (const [id, data] of sortedRewrites) {
-      const kTokens = (data.rewriteSaved / 1000).toFixed(1);
-      console.log(
-        `    ${id.padEnd(18)} ${String(data.rewriteCount).padStart(6)} rewrites   ~${kTokens.padStart(7)}k tokens`,
-      );
-    }
-    const totalHookK = (s.totalSaved / 1000).toFixed(1);
-    const hookUsd = ((s.totalSaved / 1_000_000) * 3).toFixed(2);
-    console.log(`    ${'-'.repeat(62)}`);
-    console.log(
-      `    ${'Total hook'.padEnd(18)} ${String(s.totalRewrites).padStart(6)} rewrites   ~${totalHookK.padStart(7)}k tokens (~$${hookUsd} USD)`,
-    );
-    console.log('');
-  }
-
-  if (sortedAlreadyCompact.length > 0) {
-    console.log('  Ahorro potencial ya capturado por skill/agente (sin rewrite):');
-    for (const [id, data] of sortedAlreadyCompact) {
-      const kTokens = (data.alreadyCompactPotential / 1000).toFixed(1);
-      console.log(
-        `    ${id.padEnd(18)} ${String(data.alreadyCompactCount).padStart(6)} eventos    ~${kTokens.padStart(7)}k tokens potenciales`,
-      );
-    }
-    const totalAgentK = (s.totalAlreadyCompactPotential / 1000).toFixed(1);
-    const agentUsd = ((s.totalAlreadyCompactPotential / 1_000_000) * 3).toFixed(2);
-    console.log(`    ${'-'.repeat(62)}`);
-    console.log(
-      `    ${'Total skill'.padEnd(18)} ${String(s.totalAlreadyCompact).padStart(6)} eventos    ~${totalAgentK.padStart(7)}k tokens (~$${agentUsd} USD)`,
-    );
-    console.log('');
-  }
-
-  const totalK = (s.totalObservedPotential / 1000).toFixed(1);
-  const totalUsd = ((s.totalObservedPotential / 1_000_000) * 3).toFixed(2);
-  console.log(`    ${'-'.repeat(62)}`);
-  console.log(
-    `    ${'Total observado'.padEnd(18)} ${String(s.totalEvents).padStart(6)} eventos    ~${totalK.padStart(7)}k tokens (~$${totalUsd} USD, Sonnet input)`,
-  );
-  console.log(`\n  Log: ${compactTelemetry.LOG_PATH}`);
-  if (compactTelemetry.isDisabled()) {
-    console.log('  Estado: DESHABILITADO (no se registran nuevos eventos)');
-  }
-  console.log('');
-}
-
-// --- Bus subcommands (refacil-bus: broker core — fase 1) ---
-
-async function busStart() {
-  try {
-    const { info, started } = await busSpawn.ensureBroker(packageRoot);
-    if (started) {
-      console.log(`  refacil-bus broker iniciado en 127.0.0.1:${info.port} (pid ${info.pid}).`);
-    } else {
-      console.log(`  refacil-bus broker ya estaba activo en 127.0.0.1:${info.port} (pid ${info.pid}).`);
-    }
-  } catch (err) {
-    console.error(`  No se pudo iniciar el broker: ${err.message}`);
-    process.exit(1);
-  }
-}
-
-function busStop() {
-  const result = busSpawn.stopBroker();
-  if (result.stopped) {
-    console.log(`  refacil-bus broker detenido (pid ${result.info.pid}).`);
-  } else if (result.reason === 'no-info') {
-    console.log('  refacil-bus broker no está corriendo.');
-  } else if (result.reason === 'not-alive') {
-    console.log('  refacil-bus broker no estaba vivo; info obsoleta limpiada.');
-  } else {
-    console.error(`  No se pudo detener el broker: ${result.reason}`);
-    process.exit(1);
-  }
-}
-
-async function busStatus() {
-  const status = await busSpawn.isBrokerAlive();
-  if (!status.alive) {
-    console.log('  refacil-bus broker: INACTIVO');
-    if (status.staleInfo) {
-      console.log(`  (info obsoleta encontrada: pid ${status.staleInfo.pid}, puerto ${status.staleInfo.port})`);
-    }
-    return;
-  }
-  const info = status.info;
-  const uptimeMs = Date.now() - new Date(info.startedAt).getTime();
-  const uptimeMin = Math.floor(uptimeMs / 60000);
-  console.log('  refacil-bus broker: ACTIVO');
-  console.log(`    host:    127.0.0.1`);
-  console.log(`    puerto:  ${info.port}`);
-  console.log(`    pid:     ${info.pid}`);
-  console.log(`    iniciado: ${info.startedAt}`);
-  console.log(`    uptime:  ${uptimeMin} min`);
-  console.log(`    info:    ${busBroker.BUS_INFO_PATH}`);
-}
-
-function busServe() {
-  // Invocado por spawn detached — ejecuta el broker en foreground.
-  busBroker.start().catch((err) => {
-    process.stderr.write(`Error arrancando broker: ${err.message}\n`);
-    process.exit(1);
-  });
-}
-
-function parseBusArgs(argv) {
-  const args = {};
-  for (let i = 0; i < argv.length; i++) {
-    const token = argv[i];
-    if (!token || !token.startsWith('--')) continue;
-    const key = token.slice(2);
-    const next = argv[i + 1];
-    if (next === undefined || next.startsWith('--')) {
-      args[key] = true;
-    } else {
-      args[key] = next;
-      i++;
-    }
-  }
-  return args;
-}
-
-function defaultSessionName() {
-  return path.basename(process.cwd()) || 'sesion';
-}
-
-async function connectOrDie() {
-  try {
-    const { info } = await busSpawn.ensureBroker(packageRoot);
-    const ws = await busClient.connect(info.port);
-    return { ws, info };
-  } catch (err) {
-    console.error(`  No se pudo conectar al bus: ${err.message}`);
-    process.exit(1);
-  }
-}
-
-function formatMessage(m) {
-  const target = m.to ? ` → @${m.to}` : '';
-  return `  [${m.ts}] ${m.from}${target} (${m.kind}): ${m.text}`;
-}
-
-async function busJoin(args) {
-  const session = args.session || defaultSessionName();
-  const room = args.room;
-  const repo = args.repo || process.cwd();
-  let intro = args.intro;
-  if (!intro) {
-    try {
-      intro = busPresenter.buildIntro({ repoDir: repo, session });
-    } catch (_) {
-      intro = `${session} se unió a la sala`;
-    }
-  }
-  if (!room) {
-    console.error('  Uso: refacil-sdd-ai bus join --room <sala> [--session <s>] [--intro "..."]');
-    process.exit(1);
-  }
-  const { ws } = await connectOrDie();
-  const reply = await busClient.sendAndWait(
-    ws,
-    'join',
-    { session, room, repo, intro },
-    (d) => d.type === 'system' && d.event === 'joined',
-    3000,
-  );
-  busClient.close(ws);
-  if (!reply) {
-    console.error('  Timeout uniéndose a la sala.');
-    process.exit(1);
-  }
-  const members = (reply.detail && reply.detail.members) || [];
-  console.log(`  Unido a la sala "${room}" como "${session}".`);
-  console.log(`  Miembros actuales: ${members.join(', ') || '(solo tú)'}`);
-  console.log(`  Para consultarte: /refacil:ask @${session} "..."`);
-}
-
-async function busLeave(args) {
-  const session = args.session || defaultSessionName();
-  const { ws } = await connectOrDie();
-  const reply = await busClient.sendAndWait(
-    ws,
-    'leave',
-    { session },
-    (d) => d.type === 'system' && (d.event === 'left' || d.event === 'error'),
-    3000,
-  );
-  busClient.close(ws);
-  if (reply && reply.event === 'left') {
-    console.log(`  "${session}" salió de la sala.`);
-  } else {
-    console.log(`  "${session}" no estaba en ninguna sala.`);
-  }
-}
-
-async function busSay(args) {
-  const session = args.session || defaultSessionName();
-  const text = args.text;
-  if (!text) {
-    console.error('  Uso: refacil-sdd-ai bus say --text "..." [--session <s>]');
-    process.exit(1);
-  }
-  const { ws } = await connectOrDie();
-  const reply = await busClient.sendAndWait(
-    ws,
-    'say',
-    { session, text },
-    (d) => d.type === 'system' && (d.event === 'sent' || d.event === 'error'),
-    3000,
-  );
-  busClient.close(ws);
-  if (reply && reply.event === 'sent') {
-    console.log(`  Mensaje enviado (id ${reply.detail.id}).`);
-  } else {
-    const detail = (reply && reply.detail) || 'sin respuesta';
-    console.error(`  No se pudo enviar: ${detail}`);
-    process.exit(1);
-  }
-}
-
-async function busAsk(args) {
-  const session = args.session || defaultSessionName();
-  const to = args.to;
-  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>]');
-    process.exit(1);
-  }
-  const { ws } = await connectOrDie();
-  const ack = await busClient.sendAndWait(
-    ws,
-    'ask',
-    { session, to: to.replace(/^@/, ''), text },
-    (d) => d.type === 'system' && (d.event === 'sent' || d.event === 'error'),
-    3000,
-  );
-  if (!ack || ack.event !== 'sent') {
-    busClient.close(ws);
-    const detail = (ack && ack.detail) || 'sin respuesta';
-    console.error(`  No se pudo enviar la pregunta: ${detail}`);
-    process.exit(1);
-  }
-  const correlationId = ack.detail.correlationId;
-  console.log(`  Pregunta enviada a @${to.replace(/^@/, '')} (correlationId ${correlationId}).`);
-
-  if (waitSec > 0) {
-    console.log(`  Esperando respuesta hasta ${waitSec}s...`);
-    const resp = await busClient.sendAndWait(
-      ws,
-      'ping',
-      {},
-      (d) => d.type === 'msg' && d.kind === 'reply' && d.correlationId === correlationId,
-      waitSec * 1000,
-    );
-    busClient.close(ws);
-    if (!resp) {
-      console.log(`  Sin respuesta en ${waitSec}s. Usa /refacil:inbox más tarde para recuperarla.`);
-      return;
-    }
-    console.log(`  Respuesta de @${resp.from}:`);
-    console.log(`    ${resp.text}`);
-  } else {
-    busClient.close(ws);
-    console.log('  Usa /refacil:inbox para ver respuestas.');
-  }
-}
-
-async function busReply(args) {
-  const session = args.session || defaultSessionName();
-  const text = args.text;
-  const correlationId = args.correlation || null;
-  const to = args.to ? args.to.replace(/^@/, '') : null;
-  if (!text) {
-    console.error('  Uso: refacil-sdd-ai bus reply --text "..." [--to <name>] [--correlation <id>]');
-    process.exit(1);
-  }
-  const { ws } = await connectOrDie();
-  const reply = await busClient.sendAndWait(
-    ws,
-    'reply',
-    { session, text, to, correlationId },
-    (d) => d.type === 'system' && (d.event === 'sent' || d.event === 'error'),
-    3000,
-  );
-  busClient.close(ws);
-  if (reply && reply.event === 'sent') {
-    console.log(`  Respuesta enviada (id ${reply.detail.id}).`);
-  } else {
-    const detail = (reply && reply.detail) || 'sin respuesta';
-    console.error(`  No se pudo responder: ${detail}`);
-    process.exit(1);
-  }
-}
-
-async function busHistory(args) {
-  const session = args.session || defaultSessionName();
-  const n = args.n ? parseInt(args.n, 10) : 20;
-  const { ws } = await connectOrDie();
-  const reply = await busClient.sendAndWait(
-    ws,
-    'history',
-    { session, n },
-    (d) => d.type === 'history',
-    3000,
-  );
-  busClient.close(ws);
-  if (!reply) {
-    console.log('  Sin historial.');
-    return;
-  }
-  const msgs = reply.messages || [];
-  if (msgs.length === 0) {
-    console.log('  Sin historial.');
-    return;
-  }
-  console.log(`  Últimos ${msgs.length} mensajes:`);
-  for (const m of msgs) console.log(formatMessage(m));
-}
-
-async function busInbox(args) {
-  const session = args.session || defaultSessionName();
-  const { ws } = await connectOrDie();
-  const reply = await busClient.sendAndWait(
-    ws,
-    'inbox',
-    { session },
-    (d) => d.type === 'inbox',
-    3000,
-  );
-  busClient.close(ws);
-  if (!reply) {
-    console.log('  Sin respuesta del broker.');
-    return;
-  }
-  const msgs = reply.messages || [];
-  if (msgs.length === 0) {
-    console.log('  Sin mensajes nuevos.');
-    return;
-  }
-  console.log(`  ${msgs.length} mensaje(s) nuevo(s):`);
-  for (const m of msgs) console.log(formatMessage(m));
-}
-
-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;
-  }
-  return null;
-}
-
-function printAttendQuestion(msg) {
-  console.log('  Pregunta recibida del bus:');
-  console.log(`    de:             @${msg.from}`);
-  console.log(`    correlationId:  ${msg.correlationId || '(sin id)'}`);
-  console.log(`    texto:          ${msg.text}`);
-  console.log('');
-  console.log('  Responde con: /refacil:reply "<respuesta>"');
-  console.log('  Luego vuelve a ejecutar /refacil:attend para seguir escuchando.');
-}
-
-async function busAttend(args) {
-  const session = args.session || defaultSessionName();
-  const timeoutSec = args.timeout ? parseInt(args.timeout, 10) : 540;
-  const { ws } = await connectOrDie();
-
-  // 1) Revisar preguntas pendientes en el historial antes de suscribirse al push.
-  const hist = await busClient.sendAndWait(
-    ws,
-    'history',
-    { session, n: 50 },
-    (d) => d.type === 'history',
-    3000,
-  );
-  if (hist) {
-    const pending = findFirstUnansweredAsk(hist.messages || [], session);
-    if (pending) {
-      busClient.close(ws);
-      printAttendQuestion(pending);
-      return;
-    }
-  }
-
-  // 2) Suscribirse y esperar push de ask dirigido a esta sesión.
-  const result = await new Promise((resolve) => {
-    let done = false;
-    const finish = (v) => {
-      if (done) return;
-      done = true;
-      clearTimeout(timer);
-      ws.removeListener('message', onMessage);
-      resolve(v);
-    };
-    const onMessage = (raw) => {
-      let data;
-      try { data = JSON.parse(raw.toString()); } catch (_) { return; }
-      if (data.type === 'msg' && data.kind === 'ask' && data.to === session) {
-        finish({ kind: 'message', msg: data });
-      }
-    };
-    ws.on('message', onMessage);
-    const timer = setTimeout(() => finish({ kind: 'timeout' }), timeoutSec * 1000);
-    busClient.send(ws, 'attend', { session });
-  });
-
-  busClient.close(ws);
-
-  if (result.kind === 'message') {
-    printAttendQuestion(result.msg);
-  } else {
-    console.log(`  Sin preguntas en ${timeoutSec}s. Re-ejecuta /refacil:attend para seguir escuchando.`);
-  }
-}
-
-function readPersistedSessions() {
-  try {
-    return JSON.parse(fs.readFileSync(busBroker.SESSIONS_PATH, 'utf8'));
-  } catch (_) {
-    return {};
-  }
-}
-
-async function busWatchCmd(positional, args) {
-  const session = args.session || positional || null;
-  let room = args.room || null;
-  if (session && !room) {
-    const persisted = readPersistedSessions();
-    if (persisted[session] && persisted[session].room) {
-      room = persisted[session].room;
-    }
-  }
-  if (!session && !room) {
-    console.error('  Uso: refacil-sdd-ai bus watch <session> [--room <sala>]');
-    process.exit(1);
-  }
-  try {
-    const { info } = await busSpawn.ensureBroker(packageRoot);
-    await busWatch.start({ session, room, port: info.port });
-  } catch (err) {
-    console.error(`  No se pudo iniciar el watch: ${err.message}`);
-    process.exit(1);
-  }
-}
-
-function openInBrowser(url) {
-  const { spawn } = require('child_process');
-  const platform = process.platform;
-  let cmd;
-  let args;
-  if (platform === 'win32') {
-    cmd = 'cmd';
-    args = ['/c', 'start', '""', url];
-  } else if (platform === 'darwin') {
-    cmd = 'open';
-    args = [url];
-  } else {
-    cmd = 'xdg-open';
-    args = [url];
-  }
-  try {
-    spawn(cmd, args, { detached: true, stdio: 'ignore', windowsHide: true }).unref();
-    return true;
-  } catch (_) {
-    return false;
-  }
-}
-
-async function busView() {
-  try {
-    const { info } = await busSpawn.ensureBroker(packageRoot);
-    const url = `http://127.0.0.1:${info.port}/`;
-    console.log(`  refacil-bus view disponible en: ${url}`);
-    const opened = openInBrowser(url);
-    if (!opened) {
-      console.log('  (no se pudo abrir el navegador automáticamente, abre la URL manualmente)');
-    }
-  } catch (err) {
-    console.error(`  No se pudo iniciar la vista: ${err.message}`);
-    process.exit(1);
-  }
-}
-
-async function busRooms() {
-  const { ws } = await connectOrDie();
-  const reply = await busClient.sendAndWait(
-    ws,
-    'status',
-    {},
-    (d) => d.type === 'system' && d.event === 'status',
-    3000,
-  );
-  busClient.close(ws);
-  if (!reply) {
-    console.log('  Sin respuesta del broker.');
-    return;
-  }
-  const rooms = (reply.detail && reply.detail.rooms) || {};
-  const names = Object.keys(rooms);
-  if (names.length === 0) {
-    console.log('  No hay salas activas.');
-    return;
-  }
-  console.log('  Salas activas:');
-  for (const name of names) {
-    const members = rooms[name] || [];
-    console.log(`    ${name} (${members.length}): ${members.join(', ')}`);
-  }
-}
-
-function handleBusSubcommand(sub) {
-  const rest = process.argv.slice(4);
-  const positional = rest.length > 0 && !rest[0].startsWith('--') ? rest[0] : null;
-  const args = parseBusArgs(rest);
-  switch (sub) {
-    case 'start':
-      busStart();
-      break;
-    case 'stop':
-      busStop();
-      break;
-    case 'status':
-      busStatus();
-      break;
-    case 'serve':
-      busServe();
-      break;
-    case 'join':
-      busJoin(args);
-      break;
-    case 'leave':
-      busLeave(args);
-      break;
-    case 'say':
-      busSay(args);
-      break;
-    case 'ask':
-      busAsk(args);
-      break;
-    case 'reply':
-      busReply(args);
-      break;
-    case 'history':
-      busHistory(args);
-      break;
-    case 'inbox':
-      busInbox(args);
-      break;
-    case 'rooms':
-      busRooms();
-      break;
-    case 'watch':
-      busWatchCmd(positional, args);
-      break;
-    case 'attend':
-      busAttend(args);
-      break;
-    case 'view':
-      busView();
-      break;
-    default:
-      console.log('Uso: refacil-sdd-ai bus <start|stop|status|serve|join|leave|say|ask|reply|history|inbox|rooms|watch|attend|view>');
-  }
-}
-
-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)
-    check-update  Verifica si hay una version mas reciente en npm y sincroniza compact-guidance en AGENTS.md
-    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 "..."]
-                    bus leave [--session <s>]
-                    bus say --text "..." [--session <s>]
-                    bus ask --to <name> --text "..." [--wait N] [--session <s>]
-                    bus reply --text "..." [--correlation <id>] [--to <name>]
-                    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
-    help          Muestra esta ayuda
-
-  Flujo completo:
-    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)
-
-  Requisitos:
-    - Node.js >= 20.19.0 (requerido por OpenSpec)
-    - Claude Code >= 2.1.89 (requerido por compact-bash para rewrite silencioso) o Cursor
-  `);
-}
-
-// --- Main ---
-
-const command = process.argv[2] || 'help';
-
-switch (command) {
-  case 'init':
-    init();
-    break;
-  case 'update':
-    update();
-    break;
-  case 'check-update':
-    checkUpdate();
-    break;
-  case 'check-review':
-    checkReview();
-    break;
-  case 'compact-bash':
-    compactBash.run();
-    break;
-  case 'compact':
-    handleCompactSubcommand(process.argv[3]);
-    break;
-  case 'bus':
-    handleBusSubcommand(process.argv[3]);
-    break;
-  case 'clean':
-    clean();
-    break;
-  case 'help':
-  case '--help':
-  case '-h':
-    help();
-    break;
-  default:
-    console.error(`  Comando desconocido: ${command}`);
-    help();
-    process.exit(1);
-}
+#!/usr/bin/env node
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const {
+  syncCompactGuidance,
+  removeCompactGuidance,
+} = require('../lib/compact-guidance');
+const compactBash = require('../lib/compact/bash');
+const {
+  installSkills,
+  installAgents,
+  removeSkills,
+  createClaudeMd,
+  createCursorRules,
+  readRepoVersion,
+  writeRepoVersion,
+  getPackageVersion,
+  checkNodeVersion,
+  checkClaudeCodeVersion,
+} = require('../lib/installer');
+const { installHooks, uninstallHooks } = require('../lib/hooks');
+const { handleCompact } = require('../lib/commands/compact');
+const { handleBus } = require('../lib/commands/bus');
+const { syncIgnoreFiles } = require('../lib/ignore-files');
+
+const packageRoot = path.resolve(__dirname, '..');
+const projectRoot = process.cwd();
+
+// --- Check update (SessionStart hook) ---
+
+function repoIsInitialized() {
+  return (
+    fs.existsSync(path.join(projectRoot, '.claude', 'skills')) ||
+    fs.existsSync(path.join(projectRoot, '.cursor', 'skills'))
+  );
+}
+
+function syncRepoSkillsIfStale(globalVersion) {
+  if (!repoIsInitialized()) return null;
+  const repoVersion = readRepoVersion(projectRoot);
+  if (repoVersion === globalVersion) return null;
+
+  const { execSync } = require('child_process');
+  const localCli = path.join(packageRoot, 'bin', 'cli.js');
+  try {
+    execSync(`"${process.execPath}" "${localCli}" update`, {
+      encoding: 'utf8',
+      timeout: 30000,
+      stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    writeRepoVersion(projectRoot, globalVersion);
+    return { from: repoVersion, to: globalVersion };
+  } catch (_) {
+    return { from: repoVersion, to: globalVersion, failed: true };
+  }
+}
+
+function checkUpdate() {
+  const { execSync } = require('child_process');
+  const localVersion = getPackageVersion(packageRoot);
+
+  try {
+    syncCompactGuidance(projectRoot, packageRoot);
+  } catch (err) {
+    process.stderr.write(
+      `[refacil-sdd-ai] No se pudo sincronizar compact-guidance: ${err.message}\n`,
+    );
+  }
+
+  const syncResult = syncRepoSkillsIfStale(localVersion);
+  if (syncResult && !syncResult.failed) {
+    const fromLabel = syncResult.from ? `v${syncResult.from}` : 'version desconocida';
+    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.',
+    );
+  } 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',
+    );
+  }
+
+  try {
+    const latest = execSync('npm view refacil-sdd-ai version', {
+      encoding: 'utf8',
+      timeout: 10000,
+      stdio: ['pipe', 'pipe', 'pipe'],
+    }).trim();
+
+    if (!latest || latest === localVersion) return;
+
+    try {
+      execSync('npm update -g refacil-sdd-ai', {
+        encoding: 'utf8',
+        timeout: 60000,
+        stdio: ['pipe', 'pipe', 'pipe'],
+      });
+      execSync('refacil-sdd-ai update', {
+        encoding: 'utf8',
+        timeout: 30000,
+        stdio: ['pipe', 'pipe', 'pipe'],
+      });
+      writeRepoVersion(projectRoot, latest);
+      console.log(
+        `[refacil-sdd-ai] La metodologia SDD-AI se actualizo automaticamente de v${localVersion} a v${latest}. Skills y hooks sincronizados.`,
+      );
+    } catch (_) {
+      console.log(
+        `[refacil-sdd-ai] Hay una nueva version disponible (v${localVersion} -> v${latest}) pero la actualizacion automatica fallo. ` +
+        `Informa al usuario que ejecute manualmente: npm update -g refacil-sdd-ai && refacil-sdd-ai update`,
+      );
+    }
+  } catch (_) {
+    // Silent: sin internet o registry no disponible
+  }
+}
+
+// --- Check review (PreToolUse hook) ---
+
+function checkReview() {
+  let input;
+  try {
+    const stdin = fs.readFileSync(0, 'utf8');
+    input = JSON.parse(stdin);
+  } catch (_) {
+    return;
+  }
+
+  const command = (input.tool_input && input.tool_input.command) || '';
+  if (!command.match(/git\s+push/)) return;
+
+  const changesDir = path.join(projectRoot, 'openspec', 'changes');
+  if (!fs.existsSync(changesDir)) return;
+
+  const entries = fs.readdirSync(changesDir, { withFileTypes: true });
+  const activeChanges = entries.filter(
+    (e) => e.isDirectory() && e.name !== 'archive',
+  );
+
+  if (activeChanges.length === 0) return;
+
+  const missing = activeChanges.filter(
+    (e) => !fs.existsSync(path.join(changesDir, e.name, '.review-passed')),
+  );
+
+  if (missing.length > 0) {
+    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.';
+    console.log(JSON.stringify({ decision: 'block', reason }));
+  }
+}
+
+// --- High-level commands ---
+
+function init() {
+  console.log('\n  refacil-sdd-ai: Inicializando metodologia SDD-AI...\n');
+
+  const nodeOk = checkNodeVersion();
+  if (nodeOk) console.log(`  Node.js ${process.version} OK`);
+
+  const claudeCheck = checkClaudeCodeVersion();
+  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');
+  }
+
+  const count = installSkills(packageRoot, projectRoot);
+  console.log(`  ${count} skills instaladas en .claude/skills/ y .cursor/skills/`);
+
+  const agentsCount = installAgents(packageRoot, projectRoot);
+  if (agentsCount > 0) {
+    console.log(`  ${agentsCount} sub-agentes instalados en .claude/agents/ y .cursor/agents/`);
+  }
+
+  writeRepoVersion(projectRoot, getPackageVersion(packageRoot));
+
+  if (createClaudeMd(packageRoot, projectRoot)) console.log('  CLAUDE.md OK');
+  if (createCursorRules(packageRoot, projectRoot)) console.log('  .cursorrules OK');
+
+  if (installHooks('.claude', projectRoot)) {
+    console.log('  Hook check-update agregado a .claude/settings.json');
+  }
+  if (installHooks('.cursor', projectRoot)) {
+    console.log('  Hook check-update agregado a .cursor/settings.json');
+  }
+
+  try {
+    const ignoreResult = syncIgnoreFiles(projectRoot);
+    const s = ignoreResult.claude;
+    if (s.status === 'created') {
+      console.log('  .claudeignore y .cursorignore creados');
+    } else if (s.status === 'updated') {
+      console.log(`  .claudeignore y .cursorignore actualizados (${s.added} entradas agregadas)`);
+    } else {
+      console.log('  .claudeignore y .cursorignore ya están al día');
+    }
+  } catch (err) {
+    console.error(`  Advertencia: no se pudo sincronizar ignore files: ${err.message}`);
+  }
+
+  try {
+    const result = syncCompactGuidance(projectRoot, packageRoot);
+    if (result.status === 'appended') {
+      console.log('  Bloque compact-guidance agregado a AGENTS.md');
+    } else if (result.status === 'replaced') {
+      console.log('  Bloque compact-guidance actualizado en AGENTS.md');
+    }
+  } catch (err) {
+    console.error(`  Advertencia: no se pudo sincronizar 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');
+}
+
+function update() {
+  console.log('\n  refacil-sdd-ai: Actualizando skills...\n');
+
+  const count = installSkills(packageRoot, projectRoot);
+  console.log(`  ${count} skills actualizadas en .claude/skills/ y .cursor/skills/`);
+
+  const agentsCount = installAgents(packageRoot, projectRoot);
+  if (agentsCount > 0) {
+    console.log(`  ${agentsCount} sub-agentes actualizados en .claude/agents/ y .cursor/agents/`);
+  }
+
+  writeRepoVersion(projectRoot, getPackageVersion(packageRoot));
+
+  if (installHooks('.claude', projectRoot)) {
+    console.log('  Hook check-update agregado a .claude/settings.json');
+  }
+  if (installHooks('.cursor', projectRoot)) {
+    console.log('  Hook check-update agregado a .cursor/settings.json');
+  }
+
+  try {
+    const ignoreResult = syncIgnoreFiles(projectRoot);
+    const s = ignoreResult.claude;
+    if (s.status === 'created') {
+      console.log('  .claudeignore y .cursorignore creados');
+    } else if (s.status === 'updated') {
+      console.log(`  .claudeignore y .cursorignore actualizados (${s.added} entradas agregadas)`);
+    } else {
+      console.log('  .claudeignore y .cursorignore ya están al día');
+    }
+  } catch (err) {
+    console.error(`  Advertencia: no se pudo sincronizar ignore files: ${err.message}`);
+  }
+
+  try {
+    const result = syncCompactGuidance(projectRoot, packageRoot);
+    if (result.status === 'appended') {
+      console.log('  Bloque compact-guidance agregado a AGENTS.md');
+    } else if (result.status === 'replaced') {
+      console.log('  Bloque compact-guidance actualizado en AGENTS.md');
+    }
+  } catch (err) {
+    console.error(`  Advertencia: no se pudo sincronizar compact-guidance: ${err.message}`);
+  }
+
+  console.log('\n  REINICIA tu sesion de Claude Code o Cursor para aplicar los cambios.\n');
+}
+
+function clean() {
+  console.log('\n  refacil-sdd-ai: Eliminando skills...\n');
+
+  const count = removeSkills(projectRoot);
+  console.log(`  ${count} skills eliminadas de .claude/skills/ y .cursor/skills/`);
+
+  if (uninstallHooks('.claude', projectRoot)) {
+    console.log('  Hooks SDD-AI removidos de .claude/settings.json');
+  } else {
+    console.log('  No se encontraron hooks SDD-AI para remover en .claude/settings.json.');
+  }
+  if (uninstallHooks('.cursor', projectRoot)) {
+    console.log('  Hooks SDD-AI removidos de .cursor/settings.json');
+  }
+
+  try {
+    const result = removeCompactGuidance(projectRoot);
+    if (result.status === 'removed') {
+      console.log('  Bloque compact-guidance removido de AGENTS.md');
+    }
+  } catch (err) {
+    console.error(`  Advertencia: no se pudo limpiar 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');
+}
+
+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)
+    check-update  Verifica si hay una version mas reciente en npm y sincroniza compact-guidance en AGENTS.md
+    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 "..."]
+                    bus leave [--session <s>]
+                    bus say --text "..." [--session <s>]
+                    bus ask --to <name> --text "..." [--wait N] [--session <s>]
+                    bus reply --text "..." [--correlation <id>] [--to <name>]
+                    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:
+    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)
+
+  Requisitos:
+    - Node.js >= 20.19.0 (requerido por OpenSpec)
+    - Claude Code >= 2.1.89 (requerido por compact-bash para rewrite silencioso) o Cursor
+  `);
+}
+
+// --- Main ---
+
+const command = process.argv[2] || 'help';
+
+switch (command) {
+  case 'init':
+    init();
+    break;
+  case 'update':
+    update();
+    break;
+  case 'check-update':
+    checkUpdate();
+    break;
+  case 'check-review':
+    checkReview();
+    break;
+  case 'compact-bash':
+    compactBash.run();
+    break;
+  case 'compact':
+    handleCompact(process.argv[3]);
+    break;
+  case 'bus':
+    handleBus(process.argv[3], process.argv.slice(4), packageRoot);
+    break;
+  case 'clean':
+    clean();
+    break;
+  case 'help':
+  case '--help':
+  case '-h':
+    help();
+    break;
+  default:
+    console.error(`  Comando desconocido: ${command}`);
+    help();
+    process.exit(1);
+}