@luquimbo/bi-superpowers 1.0.0

package/bin/commands/setup.js

@@ -0,0 +1,545 @@
+/**
+ * Setup Command - Onboarding Wizard
+ * ==================================
+ *
+ * Creates the bi-repo structure for multi-project BI version control.
+ * This is the first command users run after installing BI Superpowers.
+ *
+ * Usage:
+ *   super setup                    Interactive wizard
+ *   super setup --path ~/bi-repo   Specify location
+ *   super setup --skip-vscode      Don't open VS Code
+ *
+ * @module commands/setup
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { spawn } = require('child_process');
+
+const git = require('../utils/git');
+const profiles = require('../utils/profiles');
+const rl = require('../utils/readline');
+const { createMcpConfigForFormat } = require('../lib/microsoft-mcp');
+
+/**
+ * Default repo name
+ */
+const DEFAULT_REPO_NAME = 'bi-repo';
+
+/**
+ * Parse command line arguments
+ * @param {string[]} args - CLI arguments
+ * @returns {Object} Parsed options
+ */
+function parseArgs(args) {
+  const options = {
+    path: null,
+    skipVscode: false,
+    help: false,
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+
+    if (arg === '--path' || arg === '-p') {
+      options.path = args[++i];
+    } else if (arg === '--skip-vscode') {
+      options.skipVscode = true;
+    } else if (arg === '--help' || arg === '-h') {
+      options.help = true;
+    }
+  }
+
+  return options;
+}
+
+// Using shared readline utilities from ../utils/readline.js
+const { createReadline, prompt } = rl;
+
+/**
+ * Show the welcome banner
+ */
+function showWelcome() {
+  console.log(`
+╔══════════════════════════════════════════════════════════════╗
+║  BI Agent Superpowers - Setup Wizard                         ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                              ║
+║  Vamos a crear tu repositorio de proyectos BI.              ║
+║                                                              ║
+║  Este repo te permite:                                       ║
+║  • Versionar todos tus proyectos con Git                    ║
+║  • Revertir cambios si algo sale mal                        ║
+║  • Mantener tus archivos originales seguros                 ║
+║  • Organizar múltiples proyectos en un solo lugar           ║
+║  • Configurar MCPs compartidos para todo el equipo          ║
+║                                                              ║
+╚══════════════════════════════════════════════════════════════╝
+`);
+}
+
+/**
+ * Ask user about MCP configuration for the workspace
+ */
+async function configureMCPs(rl) {
+  console.log('\n─────────────────────────────────────────────────────────────');
+  console.log('  Configuración de MCPs (Model Context Protocol)');
+  console.log('─────────────────────────────────────────────────────────────\n');
+
+  console.log('Este repo se crea en modo plugin-first para Claude Code.');
+  console.log('Se configurarán por defecto los MCPs oficiales de Microsoft:\n');
+  console.log('  • powerbi-remote      (HTTP)');
+  console.log('  • fabric-mcp-server   (npx @microsoft/fabric-mcp@latest)');
+  console.log('  • powerbi-modeling-mcp (launcher local para Windows)\n');
+  console.log('Nota: el Modeling MCP local sólo funciona en Windows.');
+  console.log('En macOS/Linux podrás seguir usando powerbi-remote y Fabric MCP.\n');
+
+  const answer = await prompt(rl, '¿Continuar con esta configuración recomendada? (S/n): ');
+  const accepted = !answer || answer.toLowerCase() === 's' || answer.toLowerCase() === 'y';
+
+  return {
+    pluginFirst: accepted,
+    servers: accepted ? ['powerbi-remote', 'fabric-mcp-server', 'powerbi-modeling-mcp'] : [],
+  };
+}
+
+/**
+ * Generate MCP configuration files for AI tools
+ */
+function generateMcpConfigs(repoPath, _mcpConfig) {
+  if (_mcpConfig && _mcpConfig.pluginFirst === false) {
+    console.log('  • Omitido: archivos MCP (puedes ejecutar "bi-superpowers mcp-setup" más tarde)');
+    return;
+  }
+
+  const packageDir = path.resolve(__dirname, '..', '..');
+  const pluginMcp = createMcpConfigForFormat('plugin', {
+    packageDir,
+  });
+  fs.writeFileSync(path.join(repoPath, '.mcp.json'), JSON.stringify(pluginMcp, null, 2));
+  console.log('  ✓ Creado: .mcp.json (MCPs oficiales de Microsoft)');
+
+  // Create .cursor directory and mcp.json
+  const cursorDir = path.join(repoPath, '.cursor');
+  if (!fs.existsSync(cursorDir)) {
+    fs.mkdirSync(cursorDir, { recursive: true });
+  }
+
+  const cursorMcp = createMcpConfigForFormat('cursor', {
+    packageDir,
+  });
+  fs.writeFileSync(path.join(cursorDir, 'mcp.json'), JSON.stringify(cursorMcp, null, 2));
+  console.log('  ✓ Creado: .cursor/mcp.json (MCPs legacy)');
+
+  // Create .vscode directory and settings.json
+  const vscodeDir = path.join(repoPath, '.vscode');
+  if (!fs.existsSync(vscodeDir)) {
+    fs.mkdirSync(vscodeDir, { recursive: true });
+  }
+
+  const vscodeSettings = createMcpConfigForFormat('vscode', {
+    packageDir,
+  });
+  fs.writeFileSync(
+    path.join(vscodeDir, 'mcp-settings.json'),
+    JSON.stringify(vscodeSettings, null, 2)
+  );
+  console.log('  ✓ Creado: .vscode/mcp-settings.json (MCPs legacy)');
+}
+
+/**
+ * Show help message
+ */
+function showHelp() {
+  console.log(`
+super setup - Create your BI projects repository
+
+Usage:
+  super setup                    Interactive wizard
+  super setup --path ~/bi-repo   Specify location
+  super setup --skip-vscode      Don't prompt to open VS Code
+
+Options:
+  --path, -p <path>    Path where to create the repo
+  --skip-vscode        Skip VS Code setup prompt
+  --help, -h           Show this help message
+
+Examples:
+  super setup
+  super setup --path "C:/Users/Juan/bi-repo"
+  super setup --path ~/Documents/bi-repo --skip-vscode
+`);
+}
+
+/**
+ * Get suggested repo locations
+ */
+function getSuggestedLocations() {
+  const home = os.homedir();
+  const locations = [
+    path.join(home, DEFAULT_REPO_NAME),
+    path.join(home, 'Documents', DEFAULT_REPO_NAME),
+  ];
+
+  // Add Desktop on Windows
+  if (process.platform === 'win32') {
+    locations.push(path.join(home, 'Desktop', DEFAULT_REPO_NAME));
+  }
+
+  return locations;
+}
+
+/**
+ * Ask user to select repo location
+ */
+async function selectRepoLocation(rl) {
+  const suggestions = getSuggestedLocations();
+
+  console.log('\n¿Dónde quieres crear tu carpeta de repositorio?\n');
+
+  suggestions.forEach((loc, i) => {
+    console.log(`  ${i + 1}. ${loc}`);
+  });
+  console.log(`  ${suggestions.length + 1}. Otra ubicación (especificar)\n`);
+
+  const choice = await prompt(rl, `Selecciona (1-${suggestions.length + 1}): `);
+  const choiceNum = parseInt(choice, 10);
+
+  if (choiceNum >= 1 && choiceNum <= suggestions.length) {
+    return suggestions[choiceNum - 1];
+  } else if (choiceNum === suggestions.length + 1) {
+    const customPath = await prompt(rl, '\nEscribe la ruta completa: ');
+    return customPath || suggestions[0];
+  } else {
+    console.log('\nOpción no válida. Usando ubicación recomendada.');
+    return suggestions[0];
+  }
+}
+
+/**
+ * Create the repo directory structure
+ */
+function createRepoStructure(repoPath, mcpConfig = {}) {
+  console.log('\nCreando estructura...\n');
+
+  // Create main directories
+  const dirs = [
+    repoPath,
+    path.join(repoPath, 'projects'),
+    path.join(repoPath, 'standards'),
+    path.join(repoPath, 'snippets'),
+  ];
+
+  for (const dir of dirs) {
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+      console.log(`  ✓ Creado: ${path.relative(repoPath, dir) || path.basename(repoPath)}/`);
+    }
+  }
+
+  // Create .gitignore
+  const gitignore = `# BI Agent Superpowers - Generated gitignore
+
+# Power BI temporary files
+*.pbix.tmp
+*.pbix.lock
+
+# Excel temporary files
+~$*.xlsx
+~$*.xlsm
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# IDE
+.vscode/settings.json
+.idea/
+
+# Local user config (not versioned)
+.bi-superpowers.json
+`;
+
+  fs.writeFileSync(path.join(repoPath, '.gitignore'), gitignore);
+  console.log('  ✓ Creado: .gitignore');
+
+  // Create bi-workspace.json (versioned workspace config)
+  let workspaceMcpServers = {};
+  if (mcpConfig.pluginFirst !== false) {
+    workspaceMcpServers = {
+      'powerbi-modeling-mcp': {
+        enabled: true,
+        description: 'Microsoft Power BI Modeling MCP',
+      },
+      'powerbi-remote': {
+        enabled: true,
+        description: 'Microsoft Power BI Remote MCP',
+      },
+      'fabric-mcp-server': {
+        enabled: true,
+        mode: 'all',
+        description: 'Microsoft Fabric MCP Server',
+      },
+    };
+  }
+
+  const workspaceConfig = {
+    version: '3.1',
+    created: new Date().toISOString(),
+    projects: [],
+    mcpServers: workspaceMcpServers,
+    plugin: {
+      name: 'bi-superpowers',
+      pluginFirst: mcpConfig.pluginFirst !== false,
+    },
+    changelog: {
+      enabled: true,
+      autoGenerate: true,
+      includeInAgentContext: true,
+      recentChangesCount: 5,
+    },
+  };
+
+  fs.writeFileSync(
+    path.join(repoPath, 'bi-workspace.json'),
+    JSON.stringify(workspaceConfig, null, 2)
+  );
+  console.log('  ✓ Creado: bi-workspace.json');
+
+  // Create README.md
+  const readme = `# BI Projects Repository
+
+Este repositorio contiene tus proyectos de Business Intelligence versionados con Git.
+
+## Estructura
+
+\`\`\`
+bi-repo/
+├── projects/       # Tus proyectos de BI
+│   └── {proyecto}/
+│       ├── project.json    # Configuración y ruta al archivo original
+│       ├── definition/     # TMDL (modelo semántico)
+│       └── queries/        # Power Query (.pq)
+├── standards/      # Tus standards personalizados
+└── snippets/       # Tus snippets personalizados
+\`\`\`
+
+## Comandos Útiles
+
+\`\`\`bash
+# Añadir un proyecto
+super add "ruta/al/archivo.pbix"
+
+# Traer cambios del archivo original
+super pull
+
+# Ver historial de cambios
+git log --oneline
+
+# Revertir a una versión anterior
+git checkout HEAD~1
+super push
+\`\`\`
+
+## Notas
+
+- Los archivos originales (.pbix, .xlsx) permanecen en su ubicación original
+- Solo los archivos de texto (TMDL, queries) se versionan aquí
+- Haz commits frecuentes para tener puntos de restauración
+
+---
+Creado con [BI Agent Superpowers](https://github.com/luquimbo/bi-superpowers)
+`;
+
+  fs.writeFileSync(path.join(repoPath, 'README.md'), readme);
+  console.log('  ✓ Creado: README.md');
+
+  return true;
+}
+
+/**
+ * Initialize Git repository
+ */
+function initializeGit(repoPath) {
+  if (!git.isGitInstalled()) {
+    console.log('\n⚠ Git no está instalado. Puedes instalarlo después.');
+    console.log('  Descarga: https://git-scm.com/downloads');
+    return false;
+  }
+
+  if (git.isGitRepo(repoPath)) {
+    console.log('  ✓ Git ya inicializado');
+    return true;
+  }
+
+  const success = git.initRepo(repoPath);
+  if (success) {
+    console.log('  ✓ Git inicializado');
+
+    // Create initial commit
+    git.stageFiles(repoPath, '.');
+    git.commit(repoPath, 'Initial commit - BI Agent Superpowers repo');
+    console.log('  ✓ Commit inicial creado');
+
+    return true;
+  } else {
+    console.log('  ⚠ No se pudo inicializar Git');
+    return false;
+  }
+}
+
+/**
+ * Prompt to open VS Code
+ */
+async function promptVSCode(rl, repoPath, skipVscode) {
+  if (skipVscode) {
+    return;
+  }
+
+  console.log(`
+Ahora vamos a configurar VS Code:
+
+  1. Abre VS Code
+  2. File → Add Folder to Workspace
+  3. Selecciona: ${repoPath}
+`);
+
+  const openNow = await prompt(rl, '¿Quieres que abra VS Code automáticamente? (s/n): ');
+
+  if (openNow.toLowerCase() === 's' || openNow.toLowerCase() === 'y') {
+    try {
+      const platform = process.platform;
+
+      if (platform === 'darwin') {
+        spawn('open', ['-a', 'Visual Studio Code', repoPath], { detached: true, stdio: 'ignore' });
+      } else if (platform === 'win32') {
+        spawn('code', [repoPath], { detached: true, stdio: 'ignore' });
+      } else {
+        spawn('code', [repoPath], { detached: true, stdio: 'ignore' });
+      }
+
+      console.log('\n  ✓ VS Code abierto');
+    } catch (e) {
+      console.log('\n  ⚠ No se pudo abrir VS Code automáticamente.');
+      console.log('    Abre VS Code manualmente y añade la carpeta.');
+    }
+  }
+}
+
+/**
+ * Show completion message
+ */
+function showCompletion(repoPath) {
+  console.log(`
+════════════════════════════════════════════════════════════════
+  ¡Tu repositorio está listo!
+════════════════════════════════════════════════════════════════
+
+  Ubicación: ${repoPath}
+
+  Próximos pasos:
+
+    1. Añade tu primer proyecto:
+       super add "ruta/a/tu/archivo.pbix"
+
+    2. Trabaja en tu proyecto normalmente
+
+    3. Trae los cambios al repo:
+       super pull
+
+    4. Git guarda el historial automáticamente
+
+  Comandos útiles:
+    super add <archivo>    Añadir un proyecto
+    super pull             Traer cambios del original
+    super powers           Ver skills disponibles
+
+════════════════════════════════════════════════════════════════
+`);
+}
+
+/**
+ * Main setup command handler
+ */
+async function setupCommand(args, _config) {
+  const options = parseArgs(args);
+
+  if (options.help) {
+    showHelp();
+    return;
+  }
+
+  showWelcome();
+
+  // Check if repo already exists
+  const existingRepo = profiles.getRepoPath();
+  if (existingRepo && fs.existsSync(existingRepo)) {
+    console.log('Ya tienes un repositorio configurado en:');
+    console.log(`  ${existingRepo}\n`);
+
+    const rl = createReadline();
+    const proceed = await prompt(rl, '¿Quieres crear uno nuevo? (s/n): ');
+
+    if (proceed.toLowerCase() !== 's' && proceed.toLowerCase() !== 'y') {
+      console.log('\nUsando repositorio existente.');
+      rl.close();
+      return;
+    }
+    rl.close();
+  }
+
+  const rl = createReadline();
+
+  try {
+    // Step 1: Select location
+    let repoPath;
+    if (options.path) {
+      repoPath = path.resolve(options.path);
+      console.log(`\nUsando ubicación: ${repoPath}`);
+    } else {
+      repoPath = await selectRepoLocation(rl);
+    }
+
+    // Check if path already exists
+    if (fs.existsSync(repoPath)) {
+      const contents = fs.readdirSync(repoPath);
+      if (contents.length > 0) {
+        console.log(`\n⚠ La carpeta ya existe y no está vacía: ${repoPath}`);
+        const overwrite = await prompt(rl, '¿Quieres continuar de todos modos? (s/n): ');
+
+        if (overwrite.toLowerCase() !== 's' && overwrite.toLowerCase() !== 'y') {
+          console.log('\nCancelado.');
+          return;
+        }
+      }
+    }
+
+    // Step 2: Configure MCPs for the workspace
+    const mcpConfig = await configureMCPs(rl);
+
+    // Step 3: Create structure with MCP config
+    createRepoStructure(repoPath, mcpConfig);
+
+    // Step 4: Generate MCP config files for AI tools
+    generateMcpConfigs(repoPath, mcpConfig);
+
+    // Step 5: Initialize Git
+    initializeGit(repoPath);
+
+    // Step 4: Save repo path to global config
+    profiles.setRepoPath(repoPath);
+    console.log('  ✓ Configuración guardada');
+
+    // Step 5: VS Code setup
+    await promptVSCode(rl, repoPath, options.skipVscode);
+
+    // Done!
+    showCompletion(repoPath);
+  } finally {
+    rl.close();
+  }
+}
+
+module.exports = setupCommand;

package/bin/commands/setup.test.js

@@ -0,0 +1,46 @@
+/**
+ * Tests for Setup Command
+ * @module commands/setup.test
+ */
+
+const { test, describe, beforeEach, afterEach, mock } = require('node:test');
+const assert = require('node:assert');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// We'll test the parseArgs function and basic structure validation
+// Full integration tests would require mocking readline and git
+
+describe('Setup Command', () => {
+  test('module exports a function', () => {
+    const setupCommand = require('./setup');
+    assert.strictEqual(typeof setupCommand, 'function');
+  });
+
+  test('parseArgs handles --path option', () => {
+    // Import the module to access internal functions through the export
+    // Since parseArgs is not exported, we test through the main command
+    // This is a placeholder for when we refactor to export parseArgs
+    assert.ok(true, 'Placeholder test - parseArgs is internal');
+  });
+
+  test('parseArgs handles --skip-vscode flag', () => {
+    assert.ok(true, 'Placeholder test - parseArgs is internal');
+  });
+
+  test('parseArgs handles --help flag', () => {
+    assert.ok(true, 'Placeholder test - parseArgs is internal');
+  });
+});
+
+describe('Setup Command - Directory Structure', () => {
+  test('expected directories are defined', () => {
+    // Verify the expected structure would be created
+    const expectedDirs = ['projects', 'standards', 'snippets'];
+    const expectedFiles = ['.gitignore', '.bi-superpowers.json', 'README.md'];
+
+    assert.ok(expectedDirs.length === 3);
+    assert.ok(expectedFiles.length === 3);
+  });
+});