qdd-framework 2.10.0-rc.4 → 2.10.0-rc.41

package/README.md

@@ -13,6 +13,9 @@
 npm install -g qdd-framework --allow-scripts=qdd-framework
 ```
 
+npm 12 no corre los scripts de instalación sin esa bandera. Si instalas sin ella, la primera vez que uses `qdd` se baja su
+binario desde el release de GitHub de esa versión, fuera del bloqueo de npm.
+
 > **Conflicto con el paquete `qdd` de npm:** existe un paquete ajeno llamado `qdd` (no pertenece a QDD Framework) que también instala un comando `qdd`. Si lo tienes instalado globalmente, desinstálalo antes (`npm uninstall -g qdd`) para que `qdd` apunte a QDD Framework. Desde v1.9.22 su presencia ya no rompe la instalación (antes fallaba con `EISDIR`).
 
 ---
@@ -33,7 +36,7 @@ qdd audit     # corre las pruebas y las reglas de QDD; funciona desde cualquier
 - `qdd doctor`: Diagnóstico determinista de salud del entorno.
 - `qdd report`: Reporte ejecutivo consolidado en formato Texto, Markdown o JSON para CI/CD.
 - `qdd evolution`: Recomienda la siguiente mejora del proyecto.
-- `qdd dashboard`: Centro de Comando Web interactivo con streaming en tiempo real (SSE) y ejecución de agentes.
+- `qdd dashboard` (obsoleto; el panel que sigue es `qdd-tareas`): Centro de Comando Web interactivo con streaming en tiempo real (SSE) y ejecución de agentes.
 - `qdd run`: Pipeline secuencial de comandos con rollback, o modo supervisor con auto-reparación (`qdd run --keep-alive`).
 
 ---

package/bin/qdd.js

@@ -24,8 +24,24 @@ function versionDelPaquete() {
   }
 }
 
+function binarioActual() {
+  return rutaDelBinario({ platform: process.platform, env: process.env, dir: __dirname, version: versionDelPaquete(), existe: fs.existsSync });
+}
+
+// Con npm 12, quien instala sin --allow-scripts=qdd-framework no corrió el postinstall (FND-143): el primer qdd baja el
+// binario con el mismo instalador. Lo que escribe va a stderr: otro programa puede estar leyendo la salida de qdd.
+function bajarAlPrimerUso() {
+  const instalador = path.join(__dirname, '..', 'install.js');
+  if (fs.existsSync(binarioActual()) || !fs.existsSync(instalador)) {
+    return;
+  }
+  console.error('[QDD] qdd no tiene su binario: lo bajo ahora, porque npm no corrió su instalación.');
+  spawnSync(process.execPath, [instalador, '--primer-uso'], { stdio: ['ignore', 2, 'inherit'] });
+}
+
 function main() {
-  const binaryPath = rutaDelBinario({ platform: process.platform, env: process.env, dir: __dirname, version: versionDelPaquete(), existe: fs.existsSync });
+  bajarAlPrimerUso();
+  const binaryPath = binarioActual();
 
   const result = spawnSync(binaryPath, process.argv.slice(2), {
     stdio: 'inherit'

package/install.js

@@ -9,6 +9,8 @@ const VERSION = 'v' + pkg.version;
 const REPO = 'trdago/qdd-framework';
 // TOPE_VERSION_MS: el antivirus puede demorar la primera ejecución de un binario recién descargado.
 const TOPE_VERSION_MS = 60000;
+// TOPE_TURNO_MS: un turno más viejo que esto quedó abandonado; bajar el binario tarda mucho menos.
+const TOPE_TURNO_MS = 5 * 60 * 1000;
 
 const platformMap = {
   win32: 'windows',
@@ -76,6 +78,10 @@ function main() {
     fs.mkdirSync(binDir, { recursive: true });
   }
 
+  if (process.argv.includes('--primer-uso')) {
+    pedirTurno(path.join(binDir, '.bajando'));
+  }
+
   const binarioLocal = resolverBinarioLocal(__dirname, binaryName);
   if (binarioLocal) {
     console.log(`[QDD] Binario local detectado en ${binarioLocal}. Usando copia local para desarrollo...`);
@@ -109,10 +115,52 @@ function instalarBinarioIndicado({ origen, destino, carpeta }) {
   }
 }
 
+// tomarTurno: varios qdd sin binario a la vez (un panel, por ejemplo) no bajan cada uno el suyo.
+function tomarTurno(ruta) {
+  try {
+    fs.closeSync(fs.openSync(ruta, 'wx'));
+    return true;
+  } catch (err) {
+    if (err.code !== 'EEXIST') {
+      throw err;
+    }
+  }
+  if (Date.now() - fs.statSync(ruta).mtimeMs < TOPE_TURNO_MS) {
+    return false;
+  }
+  fs.rmSync(ruta, { force: true });
+  return tomarTurno(ruta);
+}
+
+// pedirTurno sale con 75, el «todavía no» de los pedidos, si otro qdd ya lo está bajando.
+function pedirTurno(ruta) {
+  try {
+    if (!tomarTurno(ruta)) {
+      console.error('[QDD] Otro proceso ya está bajando el binario.');
+      process.exit(75);
+    }
+  } catch (err) {
+    fallar(`no se pudo escribir en la carpeta del paquete: ${err.message}`);
+  }
+  process.on('exit', () => borrarSinFallar(ruta));
+}
+
+// carpetaDeDescarga es propia de este proceso: un postinstall y un primer uso pueden correr a la vez.
+function carpetaDeDescarga() {
+  try {
+    const carpeta = fs.mkdtempSync(path.join(__dirname, 'descarga-'));
+    process.on('exit', () => borrarSinFallar(carpeta));
+    return carpeta;
+  } catch (err) {
+    return fallar(`no se pudo escribir en la carpeta del paquete: ${err.message}`);
+  }
+}
+
 // 2. Descarga desde GitHub Releases
 function descargarDesdeRelease({ os, arch, ext, binaryName, binDir, destino, carpeta }) {
   const url = `https://github.com/${REPO}/releases/download/${VERSION}/qdd_${os}_${arch}.${ext}`;
-  const downloadDest = path.join(__dirname, `qdd-download.${ext}`);
+  const descarga = carpetaDeDescarga();
+  const downloadDest = path.join(descarga, `qdd-download.${ext}`);
 
   console.log(`[QDD] Descargando binario nativo para ${os}-${arch}...`);
   console.log(`[QDD] URL: ${url}`);
@@ -145,7 +193,7 @@ function descargarDesdeRelease({ os, arch, ext, binaryName, binDir, destino, car
   function extractBinary() {
     console.log('[QDD] Extrayendo...');
     try {
-      const bin = instalarDescarga({ os, paquete: downloadDest, carpeta: __dirname, binaryName, binDir, env: process.env, destino });
+      const bin = instalarDescarga({ os, paquete: downloadDest, carpeta: descarga, binaryName, binDir, env: process.env, destino });
       console.log('[QDD] ¡Instalación nativa completada exitosamente!');
       terminarInstalacion({ bin, carpeta });
     } catch (err) {
@@ -191,18 +239,55 @@ function respondeBinario(ruta) {
   }
 }
 
-// moverBinario copia si el destino está en otro volumen: el prefijo de npm y %LOCALAPPDATA% pueden estarlo.
-function moverBinario(origen, destino, renombrar = fs.renameSync) {
-  try {
-    renombrar(origen, destino);
-    return;
-  } catch (err) {
-    if (err.code !== 'EXDEV') {
-      throw err;
+// En Windows, un antivirus puede retener unos segundos el qdd.exe que se acaba de ejecutar (#175).
+const OCUPADO = new Set(['EBUSY', 'EPERM']);
+const ESPERA_OCUPADO_MS = 1000;
+const INTENTOS_OCUPADO = 30;
+
+function dormirSincrono(ms) {
+  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+
+// moverBinario copia si el destino está en otro volumen (el prefijo de npm y %LOCALAPPDATA% pueden estarlo) o si el
+// binario sigue ocupado tras unos 30 s: copiar solo necesita leerlo.
+function moverBinario(origen, destino, renombrar = fs.renameSync, { dormir = dormirSincrono, intentos = INTENTOS_OCUPADO } = {}) {
+  for (let i = 0; ; i++) {
+    try {
+      renombrar(origen, destino);
+      return;
+    } catch (err) {
+      if (err.code === 'EXDEV') {
+        break;
+      }
+      if (!OCUPADO.has(err.code)) {
+        throw err;
+      }
+      if (i + 1 >= intentos) {
+        break;
+      }
+      dormir(ESPERA_OCUPADO_MS);
     }
   }
   copiarBinario(origen, destino);
-  fs.rmSync(origen, { force: true });
+  borrarSinFallar(origen);
+}
+
+// quitarSiVacia no deja una carpeta de versión sin binario cuando la instalación falla (#175).
+function quitarSiVacia(carpeta) {
+  try {
+    fs.rmdirSync(carpeta);
+  } catch (_) {
+    // tiene archivos (otra instalación) o ya no está: se deja.
+  }
+}
+
+// borrarSinFallar: que no se pueda borrar algo temporal no rompe la instalación ni tapa su mensaje (#175).
+function borrarSinFallar(ruta) {
+  try {
+    fs.rmSync(ruta, { recursive: true, force: true, maxRetries: 5, retryDelay: 200 });
+  } catch (err) {
+    console.error(`[QDD] No se pudo borrar ${ruta}: ${err.message}`);
+  }
 }
 
 // copiarBinario nunca deja un binario a medias con el nombre final.
@@ -263,7 +348,12 @@ function instalarDescarga({ os, paquete, carpeta, binaryName, binDir, env, desti
   fs.chmodSync(extraido, 0o755);
   execFileSync(extraido, ['--version'], { stdio: 'pipe', timeout: TOPE_VERSION_MS });
   fs.mkdirSync(path.dirname(destino), { recursive: true });
-  moverBinario(extraido, destino);
+  try {
+    moverBinario(extraido, destino);
+  } catch (err) {
+    quitarSiVacia(path.dirname(destino));
+    throw err;
+  }
   fs.rmSync(paquete, { force: true });
   return destino;
 }
@@ -290,7 +380,7 @@ function actualizarConsola(bin) {
   }
 }
 
-module.exports = { esArchivo, estaDentroDeNodeModules, resolverBinarioLocal, comandoExtraer, instalarDescarga, codigoDeFalla, carpetaDeVersiones, destinoDelBinario, respondeBinario, moverBinario, instalarCopia, registrarVersion };
+module.exports = { esArchivo, estaDentroDeNodeModules, resolverBinarioLocal, comandoExtraer, instalarDescarga, codigoDeFalla, carpetaDeVersiones, destinoDelBinario, respondeBinario, moverBinario, instalarCopia, registrarVersion, tomarTurno };
 
 if (require.main === module) {
   main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qdd-framework",
-  "version": "2.10.0-rc.4",
+  "version": "2.10.0-rc.41",
   "description": "Quality-Driven Development Framework",
   "bin": {
     "qdd": "bin/qdd.js"