qdd-framework 1.9.16 → 1.9.19

package/README.md

@@ -0,0 +1,53 @@
+# QDD Framework — Quality-Driven Development
+
+[![NPM Version](https://img.shields.io/npm/v/qdd-framework.svg)](https://www.npmjs.com/package/qdd-framework)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+**QDD (Quality-Driven Development)** es una Plataforma de Ingeniería de Software basada en Mejora Continua y Gobernanza de Código desde el Día Cero. Asegura la calidad de producción eliminando prompts manuales mediante un Framework (Wisdom Registry), certificaciones 'Rules-as-Code', auditoría técnica automatizada (9 pilares de calidad), equipo resolutor multi-agente nivel FAANG (`/qdd resolve`), soporte completo para estándares internacionales de Inteligencia Artificial (ISO 42001, ISO 29119-11, SOC 2, ISO 23894), detección de APIs locales de LLM (Antigravity, Ollama, LM Studio) y un sistema unificado de reportes y dashboard en tiempo real.
+
+---
+
+## 🚀 Instalación Rápida
+
+```bash
+npm install -g qdd-framework
+```
+
+---
+
+## ⚡ Comandos Principales
+
+- `qdd init`: Inicializa el entorno QDD en el proyecto e inyecta la configuración MCP en IDEs compatibles (Cursor, Claude Code, Antigravity).
+- `qdd audit`: Ejecuta la auditoría estática de código sobre los 9 pilares de calidad (Zero-Else, OWASP, Twelve-Factor, AI Governance, Clean Code, etc.).
+- `qdd certify`: Valida las certificaciones del proyecto y genera el certificado histórico de calidad.
+- `qdd doctor`: Diagnóstico determinista de salud y auto-reparación del entorno.
+- `qdd report`: Genera un reporte ejecutivo consolidado en formato Texto, Markdown o JSON para CI/CD.
+- `qdd evolution`: Consulta consultiva para determinar la siguiente mejora natural del proyecto.
+- `qdd dashboard`: Centro de Comando Web interactivo con streaming en tiempo real (SSE) y ejecución de agentes.
+- `qdd run`: Pipeline secuencial de comandos o modo supervisor con auto-reparación (`qdd run --keep-alive`).
+
+---
+
+## 🤖 Integración con Inteligencia Artificial (MCP Server)
+
+QDD expone un servidor Model Context Protocol (MCP) que permite a asistentes como **Google Antigravity**, **Claude Code** y **Cursor** consultar reglas, diagnosticar problemas y ejecutar tareas de forma gobernada:
+
+- `/qdd init`
+- `/qdd validate`
+- `/qdd certify`
+- `/qdd resolve` (Equipo Resolutor FAANG)
+- `/qdd report`
+- `/qdd evolution`
+- `/qdd docs`
+
+---
+
+## 🛡️ Reglas Globales de Codificación
+1. **Cero-Else:** QDD prohíbe el uso de `else`, exigiendo cláusulas de guarda y retornos tempranos (*Early Returns*).
+2. **Salida Más Rápida Primero:** Los errores y validaciones se manejan al inicio de cada función.
+3. **Aprendizaje Perpetuo:** Todo bug encontrado se documenta como Finding y requiere un test unitario obligatorio.
+
+---
+
+## 📄 Licencia
+MIT © QDD Framework Team

package/install.js

@@ -23,51 +23,92 @@ const os = platformMap[process.platform];
 const arch = archMap[process.arch];
 
 if (!os || !arch) {
-  console.error(`Plataforma no soportada: ${process.platform} ${process.arch}`);
+  console.error(`[QDD] Plataforma no soportada: ${process.platform} ${process.arch}`);
   process.exit(1);
 }
 
 const ext = os === 'windows' ? 'zip' : 'tar.gz';
 const binaryExt = os === 'windows' ? '.exe' : '';
 const binaryName = `qdd${binaryExt}`;
-const url = `https://github.com/${REPO}/releases/download/${VERSION}/qdd_${os}_${arch}.${ext}`;
-
 const binDir = path.join(__dirname, 'bin');
+
+if (!fs.existsSync(binDir)) {
+  fs.mkdirSync(binDir, { recursive: true });
+}
+
+// 1. Detección de binario local para desarrollo
+const localBinRoot = path.join(__dirname, '..', binaryName);
+const localBinCli = path.join(__dirname, '..', 'cli', binaryName);
+
+if (fs.existsSync(localBinRoot)) {
+  console.log(`[QDD] Binario local detectado en ${localBinRoot}. Usando copia local para desarrollo...`);
+  fs.copyFileSync(localBinRoot, path.join(binDir, binaryName));
+  fs.chmodSync(path.join(binDir, binaryName), 0o755);
+  console.log('[QDD] ¡Instalación completada desde binario local!');
+  process.exit(0);
+}
+
+if (fs.existsSync(localBinCli)) {
+  console.log(`[QDD] Binario local detectado en ${localBinCli}. Usando copia local para desarrollo...`);
+  fs.copyFileSync(localBinCli, path.join(binDir, binaryName));
+  fs.chmodSync(path.join(binDir, binaryName), 0o755);
+  console.log('[QDD] ¡Instalación completada desde binario local!');
+  process.exit(0);
+}
+
+// 2. Descarga desde GitHub Releases
+const url = `https://github.com/${REPO}/releases/download/${VERSION}/qdd_${os}_${arch}.${ext}`;
 const downloadDest = path.join(__dirname, `qdd-download.${ext}`);
 
 console.log(`[QDD] Descargando binario nativo para ${os}-${arch}...`);
 console.log(`[QDD] URL: ${url}`);
 
-// Realizando la descarga del binario desde GitHub Releases
-const file = fs.createWriteStream(downloadDest);
-https.get(url, (response) => {
-  if (response.statusCode === 301 || response.statusCode === 302) {
-    return https.get(response.headers.location, (res) => {
-      res.pipe(file);
-      file.on('finish', extractBinary);
+downloadBinary(url);
+
+function downloadBinary(targetUrl) {
+  const file = fs.createWriteStream(downloadDest);
+  https.get(targetUrl, (response) => {
+    if (response.statusCode === 301 || response.statusCode === 302) {
+      if (response.headers.location) {
+        return downloadBinary(response.headers.location);
+      }
+    }
+
+    if (response.statusCode !== 200) {
+      console.error(`[QDD] Error: GitHub Release devolvió HTTP ${response.statusCode} para ${targetUrl}`);
+      console.error('[QDD] Si estás instalando desde una versión no publicada aún, compila localmente con "make build"');
+      process.exit(0); // Permitir que la instalación de npm continúe sin romper builds de CI
+    }
+
+    response.pipe(file);
+    file.on('finish', () => {
+      file.close(extractBinary);
     });
-  }
-  response.pipe(file);
-  file.on('finish', extractBinary);
-}).on('error', (err) => {
-  console.error('[QDD] Error descargando el binario:', err);
-  process.exit(1);
-});
+  }).on('error', (err) => {
+    console.error('[QDD] Error de red descargando el binario:', err.message);
+    process.exit(0);
+  });
+}
 
 function extractBinary() {
   console.log('[QDD] Extrayendo...');
   try {
     if (os === 'windows') {
-      execSync(`tar -xf ${downloadDest} -C ${__dirname}`);
+      execSync(`tar -xf "${downloadDest}" -C "${__dirname}"`);
     }
     if (os !== 'windows') {
-      execSync(`tar -xzf ${downloadDest} -C ${__dirname}`);
+      execSync(`tar -xzf "${downloadDest}" -C "${__dirname}"`);
+    }
+    const extractedBin = path.join(__dirname, binaryName);
+    if (fs.existsSync(extractedBin)) {
+      fs.renameSync(extractedBin, path.join(binDir, binaryName));
+      fs.chmodSync(path.join(binDir, binaryName), 0o755);
+    }
+    if (fs.existsSync(downloadDest)) {
+      fs.unlinkSync(downloadDest);
     }
-    fs.renameSync(path.join(__dirname, binaryName), path.join(binDir, binaryName));
-    fs.chmodSync(path.join(binDir, binaryName), 0o755);
-    fs.unlinkSync(downloadDest);
     console.log('[QDD] ¡Instalación nativa completada exitosamente!');
   } catch (err) {
-    console.error('[QDD] Error al extraer el binario:', err);
+    console.error('[QDD] Error al extraer el binario:', err.message);
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qdd-framework",
-  "version": "1.9.16",
+  "version": "1.9.19",
   "description": "Quality-Driven Development Framework",
   "bin": {
     "qdd": "bin/qdd.js"