agentic-kdd 2.0.2 → 2.0.4

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "agentic-kdd",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "description": "Autonomous development pipeline with Knowledge-Driven Development. Works with Cursor and Claude Code. Just type aa:",
   "main": "src/index.js",
   "bin": {
-    "akdd": "bin/akdd.js"
+    "akdd": "./bin/akdd.js"
   },
   "scripts": {
     "test": "node bin/akdd.js --version"
@@ -24,7 +24,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Adrianlpz211/Agentic-KDD.git"
+    "url": "https://github.com/Adrianlpz211/Agentic-KDD.git"
   },
   "homepage": "https://github.com/Adrianlpz211/Agentic-KDD",
   "engines": {

package/src/init.js

@@ -2,25 +2,19 @@
 
 const fs = require('fs-extra');
 const path = require('path');
-const https = require('https');
 const { execSync } = require('child_process');
-
-// Chalk y ora en versiones CommonJS
 const chalk = require('chalk');
 const ora = require('ora');
 const inquirer = require('inquirer');
 
 const GITHUB_REPO = 'Adrianlpz211/Agentic-KDD';
-const GITHUB_API = `https://api.github.com/repos/${GITHUB_REPO}/tarball/main`;
 const TEMP_DIR = path.join(require('os').tmpdir(), 'agentic-kdd-download');
 
-// ── Detectar stack del proyecto ────────────────────────────────
+// ── Detectar stack ─────────────────────────────────────────────
 function detectStack(projectPath) {
   const stack = {
-    hasNode: false,
-    hasPhp: false,
-    hasPython: false,
     framework: '—',
+    language: '—',
     packageManager: 'npm',
     commands: {
       install: 'npm install',
@@ -31,162 +25,141 @@ function detectStack(projectPath) {
     }
   };
 
-  // Node.js
   if (fs.existsSync(path.join(projectPath, 'package.json'))) {
-    stack.hasNode = true;
     const pkg = fs.readJsonSync(path.join(projectPath, 'package.json'), { throws: false }) || {};
     const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+    stack.language = 'TypeScript/JavaScript';
 
-    // Package manager
     if (fs.existsSync(path.join(projectPath, 'pnpm-lock.yaml'))) {
       stack.packageManager = 'pnpm';
-      stack.commands.install = 'pnpm install';
-      stack.commands.dev = 'pnpm dev';
-      stack.commands.build = 'pnpm build';
-      stack.commands.test = 'pnpm test';
-      stack.commands.lint = 'pnpm lint';
+      stack.commands = { install: 'pnpm install', dev: 'pnpm dev', build: 'pnpm build', test: 'pnpm test', lint: 'pnpm lint' };
     } else if (fs.existsSync(path.join(projectPath, 'yarn.lock'))) {
       stack.packageManager = 'yarn';
-      stack.commands.install = 'yarn install';
-      stack.commands.dev = 'yarn dev';
-      stack.commands.build = 'yarn build';
-      stack.commands.test = 'yarn test';
-      stack.commands.lint = 'yarn lint';
+      stack.commands = { install: 'yarn install', dev: 'yarn dev', build: 'yarn build', test: 'yarn test', lint: 'yarn lint' };
     }
 
-    // Framework
-    if (deps['next']) stack.framework = `Next.js ${deps['next'].replace('^', '')}`;
-    else if (deps['react']) stack.framework = `React ${deps['react'].replace('^', '')}`;
-    else if (deps['vue']) stack.framework = `Vue ${deps['vue'].replace('^', '')}`;
-    else if (deps['express']) stack.framework = `Express ${deps['express'].replace('^', '')}`;
-    else if (deps['fastify']) stack.framework = `Fastify`;
+    if (deps['next']) stack.framework = `Next.js ${deps['next'].replace('^','')}`;
+    else if (deps['vue']) stack.framework = `Vue ${deps['vue'].replace('^','')}`;
+    else if (deps['react']) stack.framework = `React`;
+    else if (deps['express']) stack.framework = `Express`;
     else if (deps['@nestjs/core']) stack.framework = `NestJS`;
   }
 
-  // PHP
   if (fs.existsSync(path.join(projectPath, 'composer.json'))) {
-    stack.hasPhp = true;
+    stack.language = 'PHP';
     stack.packageManager = 'composer';
-    stack.commands.install = 'composer install';
-    stack.commands.dev = 'php artisan serve';
-    stack.commands.build = 'composer build';
-    stack.commands.test = './vendor/bin/phpunit';
-    stack.commands.lint = 'composer lint';
+    stack.commands = { install: 'composer install', dev: 'php artisan serve', build: 'composer build', test: './vendor/bin/phpunit', lint: 'composer lint' };
     const composer = fs.readJsonSync(path.join(projectPath, 'composer.json'), { throws: false }) || {};
-    const require = composer.require || {};
-    if (require['laravel/framework']) stack.framework = 'Laravel';
+    if ((composer.require || {})['laravel/framework']) stack.framework = 'Laravel';
+    else stack.framework = 'PHP';
   }
 
-  // Python
   if (fs.existsSync(path.join(projectPath, 'pyproject.toml')) ||
       fs.existsSync(path.join(projectPath, 'requirements.txt'))) {
-    stack.hasPython = true;
+    stack.language = 'Python';
     stack.packageManager = 'pip';
-    stack.commands.install = 'pip install -r requirements.txt';
-    stack.commands.dev = 'uvicorn main:app --reload';
-    stack.commands.build = 'pip install -e .';
-    stack.commands.test = 'pytest';
-    stack.commands.lint = 'flake8';
+    stack.commands = { install: 'pip install -r requirements.txt', dev: 'uvicorn main:app --reload', build: 'pip install -e .', test: 'pytest', lint: 'flake8' };
+    stack.framework = 'Python';
   }
 
   return stack;
 }
 
-// ── Descargar archivos de Agentic KDD desde GitHub ────────────
-async function downloadFromGitHub(spinner) {
-  return new Promise((resolve, reject) => {
-    spinner.text = 'Downloading Agentic KDD from GitHub...';
-
-    const tmpFile = path.join(require('os').tmpdir(), 'agentic-kdd.tar.gz');
-
-    // Usar curl o wget si están disponibles (más confiable que https nativo)
-    try {
-      execSync(`curl -sL "https://github.com/${GITHUB_REPO}/archive/refs/heads/main.tar.gz" -o "${tmpFile}"`, {
-        stdio: 'pipe'
-      });
-
-      // Extraer
-      fs.ensureDirSync(TEMP_DIR);
-      execSync(`tar -xzf "${tmpFile}" -C "${TEMP_DIR}" --strip-components=1`, {
-        stdio: 'pipe'
-      });
-
-      fs.removeSync(tmpFile);
-      resolve(TEMP_DIR);
-    } catch (err) {
-      reject(new Error('Could not download from GitHub. Check your internet connection.'));
-    }
-  });
+// ── Detectar si el proyecto tiene contenido ────────────────────
+function detectProjectState(projectPath) {
+  const hasCode = fs.existsSync(path.join(projectPath, 'src')) ||
+                  fs.existsSync(path.join(projectPath, 'app')) ||
+                  fs.existsSync(path.join(projectPath, 'pages')) ||
+                  fs.existsSync(path.join(projectPath, 'api'));
+
+  const hasKnowledge = fs.existsSync(path.join(projectPath, '.agentic', 'conocimiento')) &&
+    fs.readdirSync(path.join(projectPath, '.agentic', 'conocimiento'))
+      .filter(f => f !== 'README.md').length > 0;
+
+  const hasPackageFile = fs.existsSync(path.join(projectPath, 'package.json')) ||
+                         fs.existsSync(path.join(projectPath, 'composer.json')) ||
+                         fs.existsSync(path.join(projectPath, 'pyproject.toml'));
+
+  return { hasCode, hasKnowledge, hasPackageFile };
 }
 
-// ── Copiar archivos de Agentic al proyecto ─────────────────────
-function copyAgenticFiles(sourcePath, projectPath, spinner) {
-  const filesToCopy = [
-    '.agentic',
-    '.cursor',
-    'CLAUDE.md',
-    '_LOCKS.md',
-    '_output',
-    'docs'
-  ];
+// ── Descargar desde GitHub ─────────────────────────────────────
+async function downloadFromGitHub(spinner) {
+  const tmpFile = path.join(require('os').tmpdir(), 'agentic-kdd.tar.gz');
+  try {
+    execSync(`curl -sL "https://github.com/${GITHUB_REPO}/archive/refs/heads/main.tar.gz" -o "${tmpFile}"`, { stdio: 'pipe' });
+    fs.ensureDirSync(TEMP_DIR);
+    execSync(`tar -xzf "${tmpFile}" -C "${TEMP_DIR}" --strip-components=1`, { stdio: 'pipe' });
+    fs.removeSync(tmpFile);
+    return TEMP_DIR;
+  } catch (err) {
+    throw new Error('No se pudo descargar desde GitHub. Verifica tu conexión.');
+  }
+}
 
-  spinner.text = 'Installing Agentic KDD files...';
+// ── Copiar archivos al proyecto ────────────────────────────────
+function copyAgenticFiles(sourcePath, projectPath) {
+  const files = ['CLAUDE.md', '_LOCKS.md', '_output', 'docs', '.cursor'];
 
-  for (const file of filesToCopy) {
+  for (const file of files) {
     const src = path.join(sourcePath, file);
     const dest = path.join(projectPath, file);
+    if (fs.existsSync(src)) fs.copySync(src, dest, { overwrite: true });
+  }
 
-    if (fs.existsSync(src)) {
-      // No sobreescribir memoria si ya existe
-      if (file === '.agentic' && fs.existsSync(dest)) {
-        // Solo actualizar agentes, no memoria ni config
-        const agentsSrc = path.join(src, 'agentes');
-        const agentsDest = path.join(dest, 'agentes');
-        if (fs.existsSync(agentsSrc)) {
-          fs.copySync(agentsSrc, agentsDest, { overwrite: true });
-        }
-        // Copiar conocimiento README si no existe
-        const knowledgeReadmeSrc = path.join(src, 'conocimiento', 'README.md');
-        const knowledgeReadmeDest = path.join(dest, 'conocimiento', 'README.md');
-        if (fs.existsSync(knowledgeReadmeSrc) && !fs.existsSync(knowledgeReadmeDest)) {
-          fs.copySync(knowledgeReadmeSrc, knowledgeReadmeDest);
-        }
-      } else {
-        fs.copySync(src, dest, { overwrite: true });
-      }
+  // .agentic — copiar agentes y estructura pero NO sobreescribir memoria si existe
+  const agSrc = path.join(sourcePath, '.agentic');
+  const agDest = path.join(projectPath, '.agentic');
+
+  if (fs.existsSync(agSrc)) {
+    // Agentes siempre se actualizan
+    fs.copySync(path.join(agSrc, 'agentes'), path.join(agDest, 'agentes'), { overwrite: true });
+
+    // Memoria y config solo si no existen
+    const memorySrc = path.join(agSrc, 'memoria');
+    const memoryDest = path.join(agDest, 'memoria');
+    if (!fs.existsSync(memoryDest)) fs.copySync(memorySrc, memoryDest);
+
+    const configDest = path.join(agDest, 'config.md');
+    if (!fs.existsSync(configDest)) {
+      fs.copySync(path.join(agSrc, 'config.md'), configDest);
     }
-  }
-}
 
-// ── Configurar config.md con el stack detectado ────────────────
-function configureProject(projectPath, stack, answers) {
-  const configPath = path.join(projectPath, '.agentic', 'config.md');
+    // PLAN.md solo si no existe
+    const planDest = path.join(agDest, 'PLAN.md');
+    if (!fs.existsSync(planDest)) {
+      fs.copySync(path.join(agSrc, 'PLAN.md'), planDest);
+    }
 
-  if (!fs.existsSync(configPath)) return;
+    // conocimiento/README siempre
+    const knSrc = path.join(agSrc, 'conocimiento', 'README.md');
+    const knDest = path.join(agDest, 'conocimiento', 'README.md');
+    fs.ensureDirSync(path.dirname(knDest));
+    if (!fs.existsSync(knDest)) fs.copySync(knSrc, knDest);
+  }
+}
 
-  const projectName = answers.name || path.basename(projectPath);
-  const projectDesc = answers.description || '—';
-  const isNew = answers.isNew;
+// ── Escribir config.md con la info recopilada ──────────────────
+function writeConfig(projectPath, data) {
+  const { name, description, isNew, stack } = data;
 
   const config = `# Agentic KDD — Configuración del proyecto
 CONFIGURADO: SI
 VERSION: 2.0
 
----
-
 ## Proyecto
-Nombre: ${projectName}
-Descripción: ${projectDesc}
+Nombre: ${name}
+Descripción: ${description}
 Tipo: ${isNew ? 'NUEVO' : 'EXISTENTE'}
 
 ## Stack
 \`\`\`yaml
 frontend:
   framework: ${stack.framework}
-  language: ${stack.hasPhp ? 'PHP' : stack.hasPython ? 'Python' : 'TypeScript'}
+  language: ${stack.language}
 
 backend:
-  runtime: ${stack.hasNode ? 'Node.js' : stack.hasPhp ? 'PHP' : 'Python'}
+  runtime: ${stack.language}
   framework: ${stack.framework}
   base_datos: —
 
@@ -201,15 +174,12 @@ commands:
   lint: ${stack.commands.lint}
 \`\`\`
 
-## Arquitectura
-_El agente Setup completa esto al analizar el proyecto._
-
 ## Módulos
 ### Implementados
-_Ninguno aún._
+_El agente Setup los detecta al correr aa: configurar_
 
 ### Pendientes
-_Ninguno aún._
+_El agente Setup los detecta al correr aa: configurar_
 
 ## Archivos compartidos críticos
 _El Setup los detecta._
@@ -221,7 +191,7 @@ _Se definen durante el desarrollo._
 _Sin sinónimos registrados aún._
 `;
 
-  fs.writeFileSync(configPath, config, 'utf8');
+  fs.writeFileSync(path.join(projectPath, '.agentic', 'config.md'), config, 'utf8');
 }
 
 // ── Comando principal: akdd init ───────────────────────────────
@@ -234,74 +204,129 @@ async function init() {
   // Verificar si ya está instalado
   const alreadyInstalled = fs.existsSync(path.join(projectPath, '.agentic', 'config.md'));
   if (alreadyInstalled) {
-    const { confirm } = await inquirer.prompt([{
+    const content = fs.readFileSync(path.join(projectPath, '.agentic', 'config.md'), 'utf8');
+    if (content.includes('CONFIGURADO: SI')) {
+      const { confirm } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'confirm',
+        message: chalk.yellow('Agentic KDD ya está instalado. ¿Reinstalar?'),
+        default: false
+      }]);
+      if (!confirm) {
+        console.log(chalk.gray('\n  Usa akdd update para actualizar sin perder tu memoria.\n'));
+        return;
+      }
+    }
+  }
+
+  // Detectar estado del proyecto
+  const state = detectProjectState(projectPath);
+  const stack = detectStack(projectPath);
+
+  // ── PREGUNTA 1 — Nuevo o existente ────────────────────────────
+  const { isNew } = await inquirer.prompt([{
+    type: 'list',
+    name: 'isNew',
+    message: '¿El proyecto es nuevo o ya está encaminado?',
+    choices: [
+      { name: 'Nuevo — empezando desde cero', value: true },
+      { name: 'Existente — ya tiene código o avance', value: false }
+    ],
+    default: !state.hasCode
+  }]);
+
+  // ── PREGUNTA 2 — Documentación ────────────────────────────────
+  let hasDocsAnswer = false;
+
+  if (!state.hasKnowledge) {
+    const { hasDocs } = await inquirer.prompt([{
       type: 'confirm',
-      name: 'confirm',
-      message: chalk.yellow('Agentic KDD is already installed in this project. Reinstall?'),
+      name: 'hasDocs',
+      message: '¿Tienes documentación del proyecto? (specs, wireframes, reglas de negocio, etc.)',
       default: false
     }]);
-    if (!confirm) {
-      console.log(chalk.gray('\n  Run akdd update to update without losing your memory.\n'));
-      return;
+    hasDocsAnswer = hasDocs;
+
+    if (hasDocs) {
+      console.log('\n' + chalk.cyan('  Sube tus archivos a la carpeta:'));
+      console.log(chalk.bold('  .agentic/conocimiento/'));
+      console.log(chalk.gray('  (PDFs, Markdown, Word, specs — cualquier formato)\n'));
+
+      await inquirer.prompt([{
+        type: 'input',
+        name: 'ready',
+        message: 'Presiona Enter cuando hayas subido los archivos...'
+      }]);
     }
+  } else {
+    console.log(chalk.green('  ✓ Encontré archivos en conocimiento/ — el Setup los leerá al configurar'));
+    hasDocsAnswer = true;
   }
 
-  // Detectar stack
-  const spinner = ora({ text: 'Detecting project stack...', color: 'blue' }).start();
-  const stack = detectStack(projectPath);
-  spinner.succeed(chalk.green(`Stack detected: ${stack.framework} (${stack.packageManager})`));
+  // ── PREGUNTA 3 — Nombre ────────────────────────────────────────
+  const { name } = await inquirer.prompt([{
+    type: 'input',
+    name: 'name',
+    message: 'Nombre del proyecto:',
+    default: path.basename(projectPath)
+  }]);
 
-  // Preguntas
-  const answers = await inquirer.prompt([
-    {
-      type: 'input',
-      name: 'name',
-      message: 'Project name:',
-      default: path.basename(projectPath)
-    },
-    {
+  // Descripción según el caso
+  let description = '—';
+
+  if (isNew && !hasDocsAnswer) {
+    // Proyecto nuevo sin docs — pedir descripción
+    const { desc } = await inquirer.prompt([{
       type: 'input',
-      name: 'description',
-      message: 'What does this project do? (1-2 lines):',
-      default: '—'
-    },
-    {
-      type: 'confirm',
-      name: 'isNew',
-      message: 'Is this a new project (from scratch)?',
-      default: !fs.existsSync(path.join(projectPath, 'src')) &&
-               !fs.existsSync(path.join(projectPath, 'app'))
-    }
-  ]);
+      name: 'desc',
+      message: 'Describe brevemente el proyecto (qué hace, para quién):',
+      validate: (v) => v.trim().length > 10 || 'Por favor da una descripción de al menos 10 caracteres'
+    }]);
+    description = desc;
+  } else if (!isNew && state.hasCode) {
+    description = 'Proyecto existente — el agente Setup detectará los módulos y describirá el proyecto al correr aa: configurar';
+  } else if (hasDocsAnswer) {
+    description = 'El agente Setup leerá conocimiento/ y generará la descripción al correr aa: configurar';
+  }
 
-  // Descargar e instalar
-  const installSpinner = ora({ text: 'Downloading Agentic KDD...', color: 'blue' }).start();
+  // ── Descargar e instalar ───────────────────────────────────────
+  const spinner = ora({ text: 'Descargando Agentic KDD desde GitHub...', color: 'blue' }).start();
 
   try {
-    const sourcePath = await downloadFromGitHub(installSpinner);
+    const sourcePath = await downloadFromGitHub(spinner);
 
-    installSpinner.text = 'Installing files...';
-    copyAgenticFiles(sourcePath, projectPath, installSpinner);
+    spinner.text = 'Instalando archivos...';
+    copyAgenticFiles(sourcePath, projectPath);
 
-    installSpinner.text = 'Configuring project...';
-    configureProject(projectPath, stack, answers);
+    spinner.text = 'Configurando proyecto...';
+    writeConfig(projectPath, { name, description, isNew, stack });
 
-    // Limpiar temp
     fs.removeSync(TEMP_DIR);
 
-    installSpinner.succeed(chalk.green('Agentic KDD installed successfully!'));
+    spinner.succeed(chalk.green('¡Agentic KDD instalado!'));
+
+    console.log('\n' + chalk.bold('  Siguiente paso — abre el proyecto en Cursor o Claude Code y escribe:\n'));
 
-    // Mensaje final
-    console.log('\n' + chalk.bold('  Ready. Open this project in Cursor or Claude Code and type:\n'));
-    console.log(chalk.cyan('  aa: configurar') + chalk.gray('   ← let the Setup agent fine-tune the configuration'));
-    console.log(chalk.cyan('  aa: [your task]') + chalk.gray('  ← start building\n'));
+    if (!isNew && state.hasCode) {
+      console.log(chalk.cyan('  aa: configurar') + chalk.gray('   ← el Setup leerá el código y configurará todo'));
+    } else if (hasDocsAnswer) {
+      console.log(chalk.cyan('  aa: configurar') + chalk.gray('   ← el Setup leerá conocimiento/ y configurará todo'));
+    } else {
+      console.log(chalk.cyan('  aa: configurar') + chalk.gray('   ← el Setup terminará la configuración'));
+    }
 
-    console.log(chalk.gray('  Documentation: https://github.com/Adrianlpz211/Agentic-KDD\n'));
+    console.log(chalk.cyan('  aa: [tu tarea]') + chalk.gray('  ← cuando esté configurado, a trabajar\n'));
+
+    if (!hasDocsAnswer && isNew) {
+      console.log(chalk.yellow('  💡 Tip: si tienes specs o docs del proyecto, súbelos a'));
+      console.log(chalk.yellow('     .agentic/conocimiento/ antes de correr aa: configurar'));
+      console.log(chalk.gray('     Esto hará que el Context Guard funcione mejor.\n'));
+    }
 
   } catch (err) {
-    installSpinner.fail(chalk.red('Installation failed'));
-    console.error(chalk.red('\n  Error: ' + err.message));
-    console.log(chalk.gray('  Try downloading manually from: https://github.com/Adrianlpz211/Agentic-KDD\n'));
+    spinner.fail(chalk.red('Error en la instalación'));
+    console.error(chalk.red('\n  ' + err.message));
+    console.log(chalk.gray('  Descarga manual: https://github.com/Adrianlpz211/Agentic-KDD\n'));
     process.exit(1);
   }
 }