qdd-framework 2.10.0-rc.3 → 2.10.0-rc.31

package/README.md

@@ -10,9 +10,12 @@
 ## 🚀 Instalación Rápida
 
 ```bash
-npm install -g qdd-framework
+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'
@@ -33,14 +49,14 @@ function main() {
 
   // Sin binario, lo más probable es que npm esté reinstalando qdd: 75 es «todavía no» para los pedidos del panel (FND-135).
   if (result.error && result.error.code === 'ENOENT') {
-    console.error('[QDD] qdd se está actualizando: inténtalo de nuevo en un momento.');
-    console.error('[QDD] Si sigue así, reinstala el paquete con: npm install -g qdd-framework');
+    console.error('[QDD] qdd no tiene su binario: se está actualizando, o npm bloqueó su instalación (npm 12 lo hace por defecto).');
+    console.error('[QDD] Si sigue así, reinstala el paquete con: npm install -g qdd-framework --allow-scripts=qdd-framework');
     process.exit(75);
   }
 
   if (result.error) {
     console.error(`[QDD] No se pudo ejecutar el binario nativo ${binaryPath}: ${result.error.message}`);
-    console.error('[QDD] Reinstala el paquete con: npm install -g qdd-framework');
+    console.error('[QDD] Reinstala el paquete con: npm install -g qdd-framework --allow-scripts=qdd-framework');
     process.exit(1);
   }
 

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', () => fs.rmSync(ruta, { force: true }));
+}
+
+// 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', () => fs.rmSync(carpeta, { recursive: true, force: true }));
+    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) {
@@ -276,7 +324,7 @@ function codigoDeFalla(env) {
 
 function fallar(motivo) {
   console.error(`[QDD] La instalación falló: ${motivo}`);
-  console.error('[QDD] Para reintentar: npm install -g qdd-framework');
+  console.error('[QDD] Para reintentar: npm install -g qdd-framework --allow-scripts=qdd-framework');
   process.exit(codigoDeFalla(process.env));
 }
 
@@ -290,7 +338,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.3",
+  "version": "2.10.0-rc.31",
   "description": "Quality-Driven Development Framework",
   "bin": {
     "qdd": "bin/qdd.js"