@luquimbo/bi-superpowers 3.1.1 → 4.1.0

package/bin/commands/changelog.js

@@ -1,443 +0,0 @@
-/**
- * Changelog Command - Generate changelog from Git history
- * ========================================================
- *
- * Generates or updates CHANGELOG.md from Git commit history.
- * Also updates the agent context file with recent changes.
- *
- * Usage:
- *   super changelog                    Generate changelog for current project
- *   super changelog --all              Generate for all projects in bi-repo
- *   super changelog --since v1.0.0     Generate since specific tag/commit
- *
- * @module commands/changelog
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const git = require('../utils/git');
-const profiles = require('../utils/profiles');
-
-/**
- * Parse command line arguments
- * @param {string[]} args - CLI arguments
- * @returns {Object} Parsed options
- */
-function parseArgs(args) {
-  const options = {
-    all: false,
-    since: null,
-    project: null,
-    help: false,
-  };
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-
-    if (arg === '--all' || arg === '-a') {
-      options.all = true;
-    } else if (arg === '--since' || arg === '-s') {
-      options.since = args[++i];
-    } else if (arg === '--project' || arg === '-p') {
-      options.project = args[++i];
-    } else if (arg === '--help' || arg === '-h') {
-      options.help = true;
-    }
-  }
-
-  return options;
-}
-
-/**
- * Show help message
- */
-function showHelp() {
-  console.log(`
-super changelog - Generar changelog desde historial Git
-
-Uso:
-  super changelog                    Generar changelog del proyecto actual
-  super changelog --all              Generar para todos los proyectos
-  super changelog --since <ref>      Generar desde tag/commit específico
-  super changelog --project <name>   Generar para proyecto específico
-
-Opciones:
-  --all, -a              Procesar todos los proyectos del bi-repo
-  --since, -s <ref>      Commit o tag desde donde generar (ej: v1.0.0, HEAD~10)
-  --project, -p <name>   Nombre del proyecto específico
-  --help, -h             Mostrar esta ayuda
-
-Ejemplos:
-  super changelog
-  super changelog --since HEAD~20
-  super changelog --all
-  super changelog --project sales-dashboard
-`);
-}
-
-/**
- * Validate git ref format to prevent command injection
- * @param {string} ref - Git reference (tag, branch, commit hash)
- * @returns {boolean} Whether the ref is valid
- */
-function isValidGitRef(ref) {
-  // Allow alphanumeric, dots, dashes, underscores, slashes (for branches like feature/foo)
-  // Also allow ~ and ^ for relative refs like HEAD~10 or HEAD^2
-  const validRefPattern = /^[a-zA-Z0-9._\-/~^]+$/;
-  return validRefPattern.test(ref) && ref.length <= 256;
-}
-
-/**
- * Get commits from Git log
- * @param {string} repoPath - Path to the repository
- * @param {string} projectPath - Path to project subdirectory (optional)
- * @param {string} since - Starting point for log (optional)
- * @returns {Array} Array of commit objects
- */
-function getCommits(repoPath, projectPath = null, since = null) {
-  const commits = [];
-
-  try {
-    const logArgs = ['log', '--pretty=format:%H|%h|%ai|%s|%an', '-n', '100'];
-
-    if (since) {
-      if (!isValidGitRef(since)) {
-        console.error(`Error: Invalid git ref format: "${since}"`);
-        console.error(
-          'Git refs must contain only alphanumeric characters, dots, dashes, underscores, slashes, ~ or ^'
-        );
-        process.exit(1);
-      }
-      logArgs.push(`${since}..HEAD`);
-    }
-
-    if (projectPath) {
-      logArgs.push('--', projectPath);
-    }
-
-    const result = git.execGitCommand(repoPath, logArgs);
-
-    if (result && result.trim()) {
-      const lines = result.trim().split('\n');
-      for (const line of lines) {
-        const [hash, shortHash, date, subject, author] = line.split('|');
-        commits.push({
-          hash,
-          shortHash,
-          date: new Date(date),
-          subject,
-          author,
-        });
-      }
-    }
-  } catch (e) {
-    // Return empty array if git log fails
-  }
-
-  return commits;
-}
-
-/**
- * Categorize commit by conventional commit type
- * @param {string} subject - Commit subject line
- * @returns {string} Category name
- */
-function categorizeCommit(subject) {
-  const lowerSubject = subject.toLowerCase();
-
-  if (lowerSubject.startsWith('feat') || lowerSubject.startsWith('add')) {
-    return 'Added';
-  } else if (lowerSubject.startsWith('fix')) {
-    return 'Fixed';
-  } else if (lowerSubject.startsWith('change') || lowerSubject.startsWith('update')) {
-    return 'Changed';
-  } else if (lowerSubject.startsWith('remove') || lowerSubject.startsWith('delete')) {
-    return 'Removed';
-  } else if (lowerSubject.startsWith('deprecate')) {
-    return 'Deprecated';
-  } else if (lowerSubject.startsWith('security')) {
-    return 'Security';
-  } else if (lowerSubject.startsWith('refactor')) {
-    return 'Changed';
-  } else if (lowerSubject.startsWith('docs')) {
-    return 'Documentation';
-  } else if (lowerSubject.startsWith('style') || lowerSubject.startsWith('format')) {
-    return 'Style';
-  } else if (lowerSubject.startsWith('test')) {
-    return 'Testing';
-  } else if (lowerSubject.startsWith('perf')) {
-    return 'Performance';
-  }
-
-  return 'Changed';
-}
-
-/**
- * Generate changelog content from commits
- * @param {Array} commits - Array of commit objects
- * @param {string} projectName - Project name for header
- * @returns {string} Markdown changelog content
- */
-function generateChangelogContent(commits, projectName) {
-  const categories = {};
-
-  // Group commits by category
-  for (const commit of commits) {
-    const category = categorizeCommit(commit.subject);
-    if (!categories[category]) {
-      categories[category] = [];
-    }
-    categories[category].push(commit);
-  }
-
-  // Build markdown content
-  let content = `# Changelog - ${projectName}
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
-
-## [Unreleased]
-
-`;
-
-  // Add categories in preferred order
-  const categoryOrder = [
-    'Added',
-    'Changed',
-    'Fixed',
-    'Removed',
-    'Deprecated',
-    'Security',
-    'Performance',
-    'Documentation',
-    'Style',
-    'Testing',
-  ];
-
-  for (const category of categoryOrder) {
-    if (categories[category] && categories[category].length > 0) {
-      content += `### ${category}\n`;
-      for (const commit of categories[category]) {
-        // Clean up commit subject (remove conventional commit prefix)
-        let subject = commit.subject
-          .replace(
-            /^(feat|fix|add|change|update|remove|delete|refactor|docs|style|test|perf|security)[\s:()[\]]*\s*/i,
-            ''
-          )
-          .trim();
-        // Capitalize first letter
-        subject = subject.charAt(0).toUpperCase() + subject.slice(1);
-        content += `- ${subject} (${commit.shortHash})\n`;
-      }
-      content += '\n';
-    }
-  }
-
-  content += `---
-*Generated by [BI Agent Superpowers](https://github.com/luquimbo/bi-superpowers) on ${new Date().toISOString().split('T')[0]}*
-`;
-
-  return content;
-}
-
-/**
- * Generate recent changes summary for agent context
- * @param {Array} commits - Array of commit objects
- * @param {number} count - Number of recent changes to include
- * @returns {string} Markdown summary
- */
-function generateRecentChangesSummary(commits, count = 5) {
-  const recentCommits = commits.slice(0, count);
-
-  if (recentCommits.length === 0) {
-    return '## Recent Changes\n\nNo recent changes recorded.\n';
-  }
-
-  let summary = '## Recent Changes\n\n';
-
-  for (const commit of recentCommits) {
-    const dateStr = commit.date.toISOString().split('T')[0];
-    summary += `- **${dateStr}**: ${commit.subject} (${commit.shortHash})\n`;
-  }
-
-  summary += '\n';
-  return summary;
-}
-
-/**
- * Update agent context file with recent changes
- * @param {string} projectPath - Path to project directory
- * @param {string} recentChanges - Recent changes markdown
- */
-function updateAgentContext(projectPath, recentChanges) {
-  // Check for Claude Code CLAUDE.md
-  const claudeDir = path.join(projectPath, '.claude');
-  const claudeMdPath = path.join(claudeDir, 'CLAUDE.md');
-
-  if (fs.existsSync(claudeMdPath)) {
-    let content = fs.readFileSync(claudeMdPath, 'utf8');
-
-    // Replace or append recent changes section
-    const recentChangesRegex = /## Recent Changes[\s\S]*?(?=##|$)/;
-
-    if (recentChangesRegex.test(content)) {
-      content = content.replace(recentChangesRegex, recentChanges);
-    } else {
-      // Append at the end
-      content += '\n' + recentChanges;
-    }
-
-    fs.writeFileSync(claudeMdPath, content);
-    console.log('  ✓ Actualizado: .claude/CLAUDE.md');
-  }
-}
-
-/**
- * Process a single project
- * @param {string} repoPath - Path to bi-repo
- * @param {string} projectName - Project name
- * @param {Object} options - Command options
- */
-function processProject(repoPath, projectName, options) {
-  const projectPath = path.join(repoPath, 'projects', projectName);
-
-  if (!fs.existsSync(projectPath)) {
-    console.log(`  ⚠ Proyecto no encontrado: ${projectName}`);
-    return;
-  }
-
-  console.log(`\nProcesando: ${projectName}`);
-
-  // Get commits for this project
-  const commits = getCommits(repoPath, path.join('projects', projectName), options.since);
-
-  if (commits.length === 0) {
-    console.log('  ℹ No se encontraron commits para este proyecto');
-    return;
-  }
-
-  console.log(`  ✓ Encontrados ${commits.length} commits`);
-
-  // Load bi-project.json to get display name and settings
-  const biProjectPath = path.join(projectPath, 'bi-project.json');
-  let displayName = projectName;
-  let changelogSettings = { enabled: true, recentChangesCount: 5 };
-
-  if (fs.existsSync(biProjectPath)) {
-    try {
-      const biProject = JSON.parse(fs.readFileSync(biProjectPath, 'utf8'));
-      displayName = biProject.displayName || projectName;
-      if (biProject.changelog) {
-        changelogSettings = { ...changelogSettings, ...biProject.changelog };
-      }
-    } catch (e) {
-      // Use defaults
-    }
-  }
-
-  if (!changelogSettings.enabled) {
-    console.log('  ℹ Changelog deshabilitado para este proyecto');
-    return;
-  }
-
-  // Generate and write changelog
-  const changelogContent = generateChangelogContent(commits, displayName);
-  const changelogPath = path.join(projectPath, 'CHANGELOG.md');
-  fs.writeFileSync(changelogPath, changelogContent);
-  console.log('  ✓ Generado: CHANGELOG.md');
-
-  // Generate recent changes summary
-  const recentChanges = generateRecentChangesSummary(commits, changelogSettings.recentChangesCount);
-
-  // Update agent context if enabled
-  if (changelogSettings.includeInAgentContext !== false) {
-    updateAgentContext(projectPath, recentChanges);
-  }
-}
-
-/**
- * Main changelog command handler
- * @param {string[]} args - Command arguments
- * @param {Object} _config - CLI configuration (unused)
- */
-async function changelogCommand(args, _config) {
-  const options = parseArgs(args);
-
-  if (options.help) {
-    showHelp();
-    return;
-  }
-
-  // Check if in bi-repo
-  const repoPath = profiles.getRepoPath();
-  if (!repoPath || !fs.existsSync(repoPath)) {
-    console.log(`
-No se encontró el repositorio de BI.
-
-Ejecuta primero:
-  super setup
-
-Para crear tu repositorio de proyectos.
-`);
-    process.exit(1);
-  }
-
-  console.log(`
-════════════════════════════════════════════════════════════════
-  BI Agent Superpowers - Changelog Generator
-════════════════════════════════════════════════════════════════
-`);
-
-  // Get list of projects
-  const projectsDir = path.join(repoPath, 'projects');
-
-  if (!fs.existsSync(projectsDir)) {
-    console.log('No hay proyectos en el repositorio.');
-    return;
-  }
-
-  const allProjects = fs
-    .readdirSync(projectsDir)
-    .filter((f) => fs.statSync(path.join(projectsDir, f)).isDirectory());
-
-  if (allProjects.length === 0) {
-    console.log('No hay proyectos en el repositorio.');
-    console.log('Usa "bi-superpowers add <archivo>" para añadir un proyecto.');
-    return;
-  }
-
-  // Determine which projects to process
-  let projectsToProcess = [];
-
-  if (options.project) {
-    if (allProjects.includes(options.project)) {
-      projectsToProcess = [options.project];
-    } else {
-      console.log(`Proyecto "${options.project}" no encontrado.`);
-      console.log(`Proyectos disponibles: ${allProjects.join(', ')}`);
-      process.exit(1);
-    }
-  } else if (options.all) {
-    projectsToProcess = allProjects;
-  } else {
-    // Default to first project or prompt
-    projectsToProcess = allProjects.slice(0, 1);
-    console.log(`Procesando proyecto: ${projectsToProcess[0]}`);
-    console.log('(Usa --all para procesar todos los proyectos)');
-  }
-
-  // Process each project
-  for (const projectName of projectsToProcess) {
-    processProject(repoPath, projectName, options);
-  }
-
-  console.log(`
-════════════════════════════════════════════════════════════════
-  ¡Changelog generado!
-════════════════════════════════════════════════════════════════
-`);
-}
-
-module.exports = changelogCommand;