refacil-sdd-ai 2.8.0 → 2.8.2

package/README.md

@@ -554,13 +554,6 @@ refacil-sdd-ai clean
 npm uninstall -g refacil-sdd-ai
 ```
 
-## Tecnologias
-
-- [OpenSpec](https://github.com/Fission-AI/OpenSpec) — Framework de especificaciones
-- [AGENTS.md](https://agents.md/) — Estandar universal de instrucciones para IA
-- [Claude Code](https://claude.ai/code) — CLI de Anthropic
-- [Cursor](https://cursor.sh) — IDE con IA
-
 ## refacil-bus
 
 Chat room local entre agentes. Permite que distintas sesiones de Claude Code o Cursor corriendo en repos diferentes se coordinen por texto plano — **sin compartir archivos, contexto ni tokens entre repos**. Cada agente responde desde el conocimiento de su propio repositorio.
@@ -712,37 +705,13 @@ El CLI prioriza ese bloque literal. Si no existe, hace fallback a `package.json`
 - Sin autenticacion: cualquier proceso local puede conectar al broker (por diseño, es solo loopback y a demanda del dev).
 - Persistencia 7 dias en `~/.refacil-sdd-ai/bus/<sala>/inbox.jsonl` (rotacion lazy al escribir).
 
-## Cambios recientes
-
-**v2.8.0** — `refacil-bus`: chat room local entre agentes:
-- Broker WebSocket local (`127.0.0.1:7821`, fallback 7822/7823) con auto-spawn
-- Persistencia por sala en `~/.refacil-sdd-ai/bus/<sala>/inbox.jsonl` con rotacion 7 dias
-- 6 skills nuevas: `join`, `say`, `ask`, `reply`, `attend`, `inbox`
-- Comandos CLI: `bus start/stop/status/watch/join/say/ask/reply/attend/inbox/history/rooms/leave`
-- Presentacion automatica al unirse usando bloque marcado en `AGENTS.md` con fallback a `package.json`
-- Soporte de conversacion automatica LLM ↔ LLM via `ask --wait` + `attend` en el otro lado
-- Funciona identico en Claude Code y Cursor (sin hooks, todo via skills)
-
-**v2.6.0** — Fase 2 del hook `compact-bash`:
-- 11 reglas nuevas: `eslint`, `biome check`, `tsc`, `prettier --check`, `npm audit`, `npm ls`, `cargo build/test/check`, `go test`, `mvn test`, `gradle test`, `ps aux` (total: 19 reglas)
-- Telemetria local en `~/.refacil-sdd-ai/compact.log`
-- Subcomandos `compact stats | disable | enable | clear-log`
-- `ps-aux` solo se activa en Unix (Linux/Mac); en Windows la regla no interviene
-
-**v2.5.0** — Fase 1 del hook `compact-bash`:
-- Hook `PreToolUse` que reescribe silenciosamente comandos Bash bare via `updatedInput` (requiere Claude Code >= 2.1.89)
-- Reglas iniciales: git log/status/diff/show, docker logs, npm/yarn/pnpm test, jest, pytest
-- Escape mecanismo `COMPACT=0 <cmd>`
-
-**v2.4.0** — Reduccion de tokens en la metodologia:
-- Boilerplate "Antes de empezar" unificado en 9 skills
-- Validacion de OpenSpec simplificada en `prereqs/SKILL.md`
-- Templates consolidados (`claude-md.md` + `cursorrules.md` → `methodology-guide.md` unico)
-- Compactacion de `review/SKILL.md`, `bug/SKILL.md`, `test/SKILL.md`
-
-**v2.3.0** — Bloque `compact-guidance` auto-gestionado en `AGENTS.md`:
-- Hook `SessionStart` sincroniza el bloque en cada sesion
-- Fuente de verdad: `templates/compact-guidance.md`
+
+## Tecnologias
+
+- [OpenSpec](https://github.com/Fission-AI/OpenSpec) — Framework de especificaciones
+- [AGENTS.md](https://agents.md/) — Estandar universal de instrucciones para IA
+- [Claude Code](https://claude.ai/code) — CLI de Anthropic
+- [Cursor](https://cursor.sh) — IDE con IA
 
 ## Licencia
 

package/bin/cli.js

@@ -125,6 +125,42 @@ function createCursorRules() {
   );
 }
 
+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) {
@@ -304,9 +340,39 @@ function uninstallHook() {
 
 // --- 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 = require(path.join(packageRoot, 'package.json')).version;
+  const localVersion = getPackageVersion();
 
   // Always ensure AGENTS.md has current compact-guidance block (silent unless error)
   try {
@@ -317,6 +383,24 @@ function checkUpdate() {
     );
   }
 
+  // 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',
@@ -326,7 +410,6 @@ function checkUpdate() {
 
     if (!latest || latest === localVersion) return;
 
-    // Auto-upgrade: the hook does it itself, LLM only sees the result
     try {
       execSync('npm update -g refacil-sdd-ai', {
         encoding: 'utf8',
@@ -338,11 +421,11 @@ function checkUpdate() {
         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 (_) {
-      // Upgrade failed — inform so the user can do it manually
       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`,
@@ -433,6 +516,7 @@ function init() {
   // Install skills
   const count = installSkills();
   console.log(`  ${count} skills instaladas en .claude/skills/ y .cursor/skills/`);
+  writeRepoVersion(projectRoot, getPackageVersion());
 
   // Create or update CLAUDE.md
   if (createClaudeMd()) {
@@ -475,6 +559,7 @@ 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/`);
+  writeRepoVersion(projectRoot, getPackageVersion());
 
   // Ensure hook is installed (for users updating from versions without hook)
   if (installHook()) {

package/lib/bus/broker.js

@@ -205,6 +205,7 @@ function handleJoin(state, ws, data) {
 
   // Si la sesión ya existe en otra sala, sacarla primero
   const existing = state.sessions.get(session);
+  const isReturningToSameRoom = !!(existing && existing.room === room);
   if (existing && existing.room && existing.room !== room) {
     leaveRoom(state, session);
   }
@@ -212,8 +213,13 @@ function handleJoin(state, ws, data) {
   const meta = existing || {};
   meta.repo = repo || meta.repo || null;
   meta.room = room;
-  meta.lastSeen = nowIso();
   meta.watchOnly = false;
+  // Primer join o cambio de sala → lastSeen = ahora (sin backlog).
+  // Reingreso a la misma sala tras desconectar → preservar lastSeen existente
+  // para que /inbox traiga los mensajes perdidos mientras estuvo fuera.
+  if (!isReturningToSameRoom || !meta.lastSeen) {
+    meta.lastSeen = nowIso();
+  }
   if (!meta.wss) meta.wss = new Set();
   state.sessions.set(session, meta);
   ws._refacilSession = session;

package/package.json

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