@luquimbo/bi-superpowers 1.0.0

package/bin/commands/build-desktop.js

@@ -0,0 +1,166 @@
+/**
+ * Build Desktop Extension Command
+ * ================================
+ *
+ * Builds a .mcpb extension for Claude Desktop by:
+ * 1. Copying desktop-extension/ template to a temp directory
+ * 2. Copying all 24 skill sources into temp/skills/
+ * 3. Installing dependencies
+ * 4. Running `npx @anthropic-ai/mcpb pack` to create the .mcpb file
+ * 5. Moving the result to the current directory
+ *
+ * Usage: super build-desktop [--output <path>]
+ *
+ * @module commands/build-desktop
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync } = require('child_process');
+
+/** Directory where the npm package is installed */
+const PACKAGE_DIR = path.dirname(path.dirname(__dirname));
+
+/** Desktop extension template source */
+const DESKTOP_TEMPLATE_DIR = path.join(PACKAGE_DIR, 'desktop-extension');
+
+/** Skill source files directory */
+const SKILLS_SOURCE_DIR = path.join(PACKAGE_DIR, 'src', 'content', 'skills');
+
+/**
+ * Build the .mcpb extension for Claude Desktop.
+ *
+ * @param {string[]} args - CLI arguments
+ * @param {Object} config - Command config from CLI
+ */
+module.exports = function buildDesktop(_args, _config) {
+  const outputDir = process.cwd();
+
+  console.log(`
+BI Agent Superpowers — Build Desktop Extension
+================================================
+`);
+
+  // Verify template exists
+  if (!fs.existsSync(DESKTOP_TEMPLATE_DIR)) {
+    console.error('Error: desktop-extension/ template not found in package.');
+    console.error('Try reinstalling: npm install -g @luquimbo/bi-superpowers');
+    process.exit(1);
+  }
+
+  // Verify skills exist
+  if (!fs.existsSync(SKILLS_SOURCE_DIR)) {
+    console.error('Error: skill sources not found. Run "super unlock" first.');
+    process.exit(1);
+  }
+
+  // Create temp build directory
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'bi-superpowers-mcpb-'));
+
+  try {
+    console.log('  Preparing build directory...');
+
+    // Copy template files (manifest.json, server.js, package.json)
+    for (const file of ['manifest.json', 'server.js', 'package.json']) {
+      const src = path.join(DESKTOP_TEMPLATE_DIR, file);
+      if (fs.existsSync(src)) {
+        fs.copyFileSync(src, path.join(tmpDir, file));
+      }
+    }
+
+    // Copy all skill .md files into temp/skills/
+    const skillsOutDir = path.join(tmpDir, 'skills');
+    fs.mkdirSync(skillsOutDir, { recursive: true });
+
+    const skillFiles = fs.readdirSync(SKILLS_SOURCE_DIR).filter((f) => f.endsWith('.md'));
+    for (const file of skillFiles) {
+      fs.copyFileSync(path.join(SKILLS_SOURCE_DIR, file), path.join(skillsOutDir, file));
+    }
+    console.log(`  Bundled ${skillFiles.length} skills`);
+
+    // Patch template placeholder versions with the real package version
+    const pkgVersion = require(path.join(PACKAGE_DIR, 'package.json')).version;
+    for (const file of ['manifest.json', 'package.json']) {
+      const filePath = path.join(tmpDir, file);
+      if (fs.existsSync(filePath)) {
+        const content = fs.readFileSync(filePath, 'utf8');
+        fs.writeFileSync(
+          filePath,
+          content.replace(/"version":\s*"[^"]*"/, `"version": "${pkgVersion}"`),
+          'utf8'
+        );
+      }
+    }
+    const serverPath = path.join(tmpDir, 'server.js');
+    if (fs.existsSync(serverPath)) {
+      const content = fs.readFileSync(serverPath, 'utf8');
+      fs.writeFileSync(
+        serverPath,
+        content.replace(/version:\s*'[^']*'/, `version: '${pkgVersion}'`),
+        'utf8'
+      );
+    }
+
+    // Install dependencies in temp dir
+    console.log('  Installing dependencies...');
+    execSync('npm install --production --silent', {
+      cwd: tmpDir,
+      stdio: 'pipe',
+      shell: true, // Required for Windows compatibility
+    });
+
+    // Pack into .mcpb using the official CLI
+    console.log('  Packing .mcpb extension...');
+    try {
+      execSync(`npx --yes @anthropic-ai/mcpb pack "${tmpDir}"`, {
+        cwd: outputDir,
+        stdio: 'pipe',
+        shell: true, // Required for Windows compatibility
+      });
+    } catch (packErr) {
+      // If mcpb CLI is not available, create zip with adm-zip (cross-platform)
+      console.log('  Note: @anthropic-ai/mcpb not available, creating zip archive...');
+      const AdmZip = require('adm-zip');
+      const zip = new AdmZip();
+      zip.addLocalFolder(tmpDir);
+      const mcpbFile = path.join(outputDir, 'bi-superpowers.mcpb');
+      zip.writeZip(mcpbFile);
+    }
+
+    // Check for output file (mcpb CLI may name it with version suffix)
+    const possibleOutputs = [
+      path.join(outputDir, 'bi-superpowers.mcpb'),
+      path.join(outputDir, `bi-superpowers-${pkgVersion}.mcpb`),
+    ];
+    const outputFile = possibleOutputs.find((f) => fs.existsSync(f));
+
+    if (outputFile) {
+      const size = (fs.statSync(outputFile).size / 1024).toFixed(1);
+      console.log(`
+  Done! Extension built successfully.
+
+  Output: ${outputFile} (${size} KB)
+
+  To install in Claude Desktop:
+    1. Double-click the .mcpb file, or
+    2. Go to Settings > Extensions > Install Extension
+
+  The extension adds ${skillFiles.length} BI skills as MCP prompts.
+  Use the "setup-mcp" prompt for Power BI/Fabric MCP configuration.
+`);
+    } else {
+      console.log('\n  Build complete. Check current directory for .mcpb file.');
+    }
+  } catch (err) {
+    console.error(`\nBuild failed: ${err.message}`);
+    process.exit(1);
+  } finally {
+    // Clean up temp directory
+    try {
+      fs.rmSync(tmpDir, { recursive: true, force: true });
+    } catch (_) {
+      // Ignore cleanup errors
+    }
+  }
+};

package/bin/commands/changelog.js

@@ -0,0 +1,443 @@
+/**
+ * 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;