@luquimbo/bi-superpowers 1.0.0

package/bin/commands/add.js

@@ -0,0 +1,533 @@
+/**
+ * Add Command - Add Project to Repository
+ * =========================================
+ *
+ * Adds a Power BI or Excel project to the bi-repo.
+ * Extracts versionable content (TMDL, queries) and creates project config.
+ *
+ * Usage:
+ *   super add "C:/path/to/file.pbix"
+ *   super add "C:/path/to/file.pbix" --profile finance
+ *   super add "C:/path/to/file.xlsx" --name budget-2026
+ *
+ * @module commands/add
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const git = require('../utils/git');
+const profiles = require('../utils/profiles');
+const pbix = require('../utils/pbix');
+const rl = require('../utils/readline');
+
+// Using shared readline utilities
+const { createReadline, prompt } = rl;
+
+/**
+ * Parse command line arguments
+ * @param {string[]} args - CLI arguments
+ * @returns {Object} Parsed options
+ */
+function parseArgs(args) {
+  const options = {
+    filePath: null,
+    name: null,
+    profile: null,
+    help: false,
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+
+    if (arg === '--name' || arg === '-n') {
+      options.name = args[++i];
+    } else if (arg === '--profile' || arg === '-p') {
+      options.profile = args[++i];
+    } else if (arg === '--help' || arg === '-h') {
+      options.help = true;
+    } else if (!arg.startsWith('-') && !options.filePath) {
+      options.filePath = arg;
+    }
+  }
+
+  return options;
+}
+
+// Readline functions imported from ../utils/readline.js
+
+/**
+ * Show help message
+ */
+function showHelp() {
+  console.log(`
+super add - Añadir un proyecto BI al repositorio
+
+Uso:
+  super add <archivo>                   Añadir un proyecto
+  super add <archivo> --profile <nombre>  Añadir con perfil específico
+  super add <archivo> --name <nombre>     Especificar nombre del proyecto
+
+Argumentos:
+  <archivo>    Ruta al archivo .pbix, .pbip o .xlsx
+
+Opciones:
+  --name, -n <nombre>       Nombre personalizado del proyecto (slug)
+  --profile, -p <nombre>    Perfil a usar (default, finance, retail, etc.)
+  --help, -h                Mostrar esta ayuda
+
+Ejemplos:
+  super add "C:/Users/Juan/Documents/Sales.pbix"
+  super add "./Dashboard.pbix" --profile finance
+  super add "Budget.xlsx" --name budget-2026 --profile finance
+`);
+}
+
+/**
+ * Get or create project name
+ */
+async function getProjectName(rl, fileInfo, customName) {
+  if (customName) {
+    return pbix.generateSlug(customName);
+  }
+
+  const suggested = pbix.generateSlug(fileInfo.name);
+  console.log(`\nNombre detectado: ${fileInfo.name}`);
+  const input = await prompt(rl, `Nombre del proyecto [${suggested}]: `);
+
+  return input ? pbix.generateSlug(input) : suggested;
+}
+
+/**
+ * Select profile for the project
+ */
+async function selectProfile(rl, customProfile) {
+  if (customProfile) {
+    // Validate profile exists or create it
+    if (!profiles.profileExists(customProfile)) {
+      console.log(`\nPerfil "${customProfile}" no existe. Creándolo...`);
+      profiles.createProfile(customProfile, { inheritsFrom: 'default' });
+    }
+    return customProfile;
+  }
+
+  const availableProfiles = profiles.listProfiles();
+
+  console.log('\nPerfil a usar:');
+  availableProfiles.forEach((p, i) => {
+    console.log(`  ${i + 1}. ${p}`);
+  });
+
+  const choice = await prompt(rl, `\nSelecciona (1-${availableProfiles.length}): `);
+  const choiceNum = parseInt(choice, 10);
+
+  if (choiceNum >= 1 && choiceNum <= availableProfiles.length) {
+    return availableProfiles[choiceNum - 1];
+  }
+
+  return 'default';
+}
+
+/**
+ * Create project directory in repo
+ */
+function createProjectDirectory(repoPath, projectName) {
+  const projectDir = path.join(repoPath, 'projects', projectName);
+
+  if (fs.existsSync(projectDir)) {
+    return { exists: true, path: projectDir };
+  }
+
+  fs.mkdirSync(projectDir, { recursive: true });
+  fs.mkdirSync(path.join(projectDir, 'definition'), { recursive: true });
+  fs.mkdirSync(path.join(projectDir, 'queries'), { recursive: true });
+
+  return { exists: false, path: projectDir };
+}
+
+/**
+ * Extract content based on file type
+ */
+function extractContent(fileInfo, projectDir) {
+  const result = {
+    success: false,
+    files: [],
+    message: '',
+  };
+
+  if (fileInfo.type === 'power-bi-project') {
+    // PBIP - extract TMDL directly
+    const extraction = pbix.extractPbipToRepo(fileInfo.path, projectDir);
+    if (extraction.success) {
+      result.success = true;
+      result.files = extraction.files;
+      result.message = `Extraídos ${extraction.files.length} archivos TMDL`;
+    } else {
+      result.message = extraction.error;
+    }
+  } else if (fileInfo.type === 'power-bi') {
+    // PBIX - binary file, cannot extract directly
+    // We'll create a placeholder and instruct user to save as PBIP
+    result.success = true;
+    result.message = `
+NOTA: Los archivos .pbix son binarios y no se pueden versionar directamente.
+
+Para versionar tu modelo, tienes dos opciones:
+
+1. RECOMENDADO: Guarda como proyecto PBIP
+   - En Power BI Desktop: File → Save as → Power BI Project (.pbip)
+   - Luego ejecuta: super add "ruta/al/proyecto.pbip"
+
+2. Usar el formato actual:
+   - El proyecto se añadirá con referencia al .pbix
+   - Los cambios se detectarán por fecha de modificación
+   - No podrás ver diferencias detalladas en Git`;
+
+    // Create a note file
+    const noteContent = `# ${fileInfo.name}
+
+Este proyecto está vinculado a un archivo .pbix binario.
+
+## Archivo Original
+- Ruta: ${fileInfo.path}
+- Tipo: Power BI Desktop (.pbix)
+
+## Para mejor versionado
+
+Considera guardar como Power BI Project (.pbip):
+1. Abre el archivo en Power BI Desktop
+2. File → Save as → Power BI Project (.pbip)
+3. Ejecuta: super add "ruta/al/proyecto.pbip"
+
+Los archivos .pbip contienen TMDL (texto) que Git puede versionar correctamente.
+`;
+
+    fs.writeFileSync(path.join(projectDir, 'README.md'), noteContent);
+    result.files = ['README.md'];
+  } else if (fileInfo.type === 'excel' || fileInfo.type === 'excel-macro') {
+    // Excel - create documentation placeholder
+    result.success = true;
+
+    const workbookDir = path.join(projectDir, 'workbook');
+    if (!fs.existsSync(workbookDir)) {
+      fs.mkdirSync(workbookDir, { recursive: true });
+    }
+
+    const structureContent = `# ${fileInfo.name}
+
+## Estructura del Workbook
+
+Documenta aquí la estructura de tu workbook:
+
+### Hojas
+-
+
+### Tablas
+-
+
+### Rangos Nombrados
+-
+
+### Conexiones de Datos
+-
+`;
+
+    fs.writeFileSync(path.join(workbookDir, 'structure.md'), structureContent);
+
+    const formulasContent = `# Fórmulas Importantes
+
+Documenta aquí las fórmulas clave de tu workbook:
+
+## Cálculos Principales
+
+\`\`\`excel
+=EXAMPLE_FORMULA()
+\`\`\`
+
+## Lookups
+
+## Agregaciones
+`;
+
+    fs.writeFileSync(path.join(workbookDir, 'formulas.md'), formulasContent);
+
+    result.files = ['workbook/structure.md', 'workbook/formulas.md'];
+    result.message = 'Creada estructura para documentar el workbook Excel';
+  } else {
+    result.message = 'Tipo de archivo no soportado';
+  }
+
+  return result;
+}
+
+/**
+ * Update repo config with new project
+ */
+function updateRepoConfig(repoPath, projectName, projectConfig) {
+  const configPath = path.join(repoPath, '.bi-superpowers.json');
+
+  let config = { version: '3.0', projects: [] };
+  if (fs.existsSync(configPath)) {
+    try {
+      config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    } catch (e) {
+      // Use default
+    }
+  }
+
+  // Add or update project
+  const existingIndex = config.projects.findIndex((p) => p.name === projectName);
+  if (existingIndex >= 0) {
+    config.projects[existingIndex] = projectConfig;
+  } else {
+    config.projects.push(projectConfig);
+  }
+
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+}
+
+/**
+ * Main add command handler
+ */
+async function addCommand(args, _config) {
+  const options = parseArgs(args);
+
+  if (options.help) {
+    showHelp();
+    return;
+  }
+
+  // Check if repo exists
+  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);
+  }
+
+  // Check if file path provided
+  if (!options.filePath) {
+    console.log(`
+Uso: super add <archivo>
+
+Ejemplo:
+  super add "C:/Users/Juan/Documents/Sales.pbix"
+  super add ./Dashboard.pbip --profile finance
+`);
+    process.exit(1);
+  }
+
+  // Resolve and validate file path
+  const filePath = path.resolve(options.filePath);
+
+  // Security: Validate path to prevent path traversal attacks
+  // Ensure the resolved path is within expected locations (user's folders, not system paths)
+  const normalizedPath = path.normalize(filePath);
+  const systemPaths = [
+    path.normalize('C:\\Windows'),
+    path.normalize('C:\\Program Files'),
+    path.normalize('C:\\Program Files (x86)'),
+    '/etc',
+    '/usr',
+    '/bin',
+    '/sbin',
+    '/var',
+    '/root',
+  ];
+
+  const isSystemPath = systemPaths.some((sysPath) =>
+    normalizedPath.toLowerCase().startsWith(sysPath.toLowerCase())
+  );
+
+  if (isSystemPath) {
+    console.log('\n✗ Access denied: Cannot add files from system directories');
+    console.log('  Please use files from your user directories.');
+    process.exit(1);
+  }
+
+  const fileInfo = pbix.detectFileType(filePath);
+
+  if (!fileInfo.exists) {
+    console.log(`\n✗ Archivo no encontrado: ${filePath}`);
+    process.exit(1);
+  }
+
+  if (fileInfo.type === 'unknown') {
+    console.log(`\n✗ Tipo de archivo no soportado: ${fileInfo.extension}`);
+    console.log('  Formatos soportados: .pbix, .pbip, .xlsx, .xlsm');
+    process.exit(1);
+  }
+
+  console.log(`
+════════════════════════════════════════════════════════════════
+  Añadir Proyecto
+════════════════════════════════════════════════════════════════
+
+  Archivo: ${fileInfo.name}${fileInfo.extension}
+  Tipo: ${fileInfo.type}
+  Ruta: ${filePath}
+`);
+
+  const rl = createReadline();
+
+  try {
+    // Get project name
+    const projectName = await getProjectName(rl, fileInfo, options.name);
+
+    // Select profile
+    const profile = await selectProfile(rl, options.profile);
+
+    // Create project directory
+    const projectDir = createProjectDirectory(repoPath, projectName);
+
+    if (projectDir.exists) {
+      const overwrite = await prompt(
+        rl,
+        `\nEl proyecto "${projectName}" ya existe. ¿Sobrescribir? (s/n): `
+      );
+      if (overwrite.toLowerCase() !== 's' && overwrite.toLowerCase() !== 'y') {
+        console.log('\nCancelado.');
+        return;
+      }
+    }
+
+    console.log(`\nCreando proyecto: ${projectName}`);
+    console.log(`  Directorio: ${projectDir.path}`);
+    console.log(`  Perfil: ${profile}`);
+
+    // Extract content
+    const extraction = extractContent(fileInfo, projectDir.path);
+
+    if (extraction.success) {
+      console.log(`\n  ✓ ${extraction.message}`);
+
+      if (extraction.files.length > 0) {
+        console.log('  Archivos:');
+        extraction.files.slice(0, 5).forEach((f) => {
+          console.log(`    - ${f}`);
+        });
+        if (extraction.files.length > 5) {
+          console.log(`    ... y ${extraction.files.length - 5} más`);
+        }
+      }
+    } else if (extraction.message) {
+      console.log(extraction.message);
+    }
+
+    // Create project.json (legacy, for backward compatibility)
+    const projectConfig = pbix.createProjectConfig({
+      name: projectName,
+      displayName: fileInfo.name,
+      type: fileInfo.type,
+      profile: profile,
+      sourcePath: filePath,
+    });
+
+    fs.writeFileSync(
+      path.join(projectDir.path, 'project.json'),
+      JSON.stringify(projectConfig, null, 2)
+    );
+    console.log('  ✓ Creado: project.json');
+
+    // Create bi-project.json (versioned project config - NEW in v2.4)
+    const biProjectConfig = {
+      version: '1.0',
+      name: projectName,
+      displayName: fileInfo.name,
+      type: fileInfo.type,
+      profile: profile,
+      sourcePath: filePath,
+      created: new Date().toISOString(),
+      mcpServers: {
+        'powerbi-modeling-mcp': {
+          enabled: true,
+          launcher: 'official-microsoft',
+        },
+        'powerbi-remote': {
+          enabled: false,
+          semanticModelId: null,
+        },
+        'fabric-mcp-server': {
+          enabled: true,
+          mode: 'all',
+        },
+      },
+      changelog: {
+        enabled: true,
+        path: 'CHANGELOG.md',
+        includeInAgentContext: true,
+        recentChangesCount: 5,
+      },
+      agentContext: {
+        includeRecentChanges: true,
+        customInstructions: null,
+      },
+    };
+
+    fs.writeFileSync(
+      path.join(projectDir.path, 'bi-project.json'),
+      JSON.stringify(biProjectConfig, null, 2)
+    );
+    console.log('  ✓ Creado: bi-project.json (configuración versionada)');
+
+    // Create initial CHANGELOG.md
+    const changelogContent = `# Changelog - ${fileInfo.name}
+
+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]
+
+### Added
+- Initial project setup with BI Agent Superpowers
+
+---
+*Generated by [BI Agent Superpowers](https://github.com/luquimbo/bi-superpowers)*
+`;
+
+    fs.writeFileSync(path.join(projectDir.path, 'CHANGELOG.md'), changelogContent);
+    console.log('  ✓ Creado: CHANGELOG.md');
+
+    // Update repo config
+    updateRepoConfig(repoPath, projectName, {
+      name: projectName,
+      type: fileInfo.type,
+      profile: profile,
+    });
+
+    // Git commit
+    if (git.isGitRepo(repoPath)) {
+      git.stageFiles(repoPath, '.');
+      git.commit(repoPath, `Add project: ${projectName}`);
+      console.log(`  ✓ Commit: "Add project: ${projectName}"`);
+    }
+
+    console.log(`
+════════════════════════════════════════════════════════════════
+  ¡Proyecto añadido!
+════════════════════════════════════════════════════════════════
+
+  Los archivos originales permanecen en:
+    ${filePath}
+
+  Para traer cambios del original al repo:
+    super pull ${projectName}
+
+  Para ver el historial:
+    cd "${repoPath}" && git log --oneline
+
+════════════════════════════════════════════════════════════════
+`);
+  } finally {
+    rl.close();
+  }
+}
+
+module.exports = addCommand;

package/bin/commands/add.test.js

@@ -0,0 +1,77 @@
+/**
+ * Tests for Add Command
+ * @module commands/add.test
+ */
+
+const { test, describe } = require('node:test');
+const assert = require('node:assert');
+const path = require('path');
+
+describe('Add Command', () => {
+  test('module exports a function', () => {
+    const addCommand = require('./add');
+    assert.strictEqual(typeof addCommand, 'function');
+  });
+});
+
+describe('Add Command - File Type Detection', () => {
+  test('detects .pbix files', () => {
+    const pbix = require('../utils/pbix');
+    const result = pbix.detectFileType('/path/to/file.pbix');
+    assert.strictEqual(result.type, 'power-bi');
+    assert.strictEqual(result.extension, '.pbix');
+  });
+
+  test('detects .pbip files', () => {
+    const pbix = require('../utils/pbix');
+    const result = pbix.detectFileType('/path/to/file.pbip');
+    assert.strictEqual(result.type, 'power-bi-project');
+    assert.strictEqual(result.extension, '.pbip');
+  });
+
+  test('detects .xlsx files', () => {
+    const pbix = require('../utils/pbix');
+    const result = pbix.detectFileType('/path/to/file.xlsx');
+    assert.strictEqual(result.type, 'excel');
+    assert.strictEqual(result.extension, '.xlsx');
+  });
+
+  test('detects .xlsm files', () => {
+    const pbix = require('../utils/pbix');
+    const result = pbix.detectFileType('/path/to/file.xlsm');
+    assert.strictEqual(result.type, 'excel-macro');
+    assert.strictEqual(result.extension, '.xlsm');
+  });
+
+  test('handles unknown file types', () => {
+    const pbix = require('../utils/pbix');
+    const result = pbix.detectFileType('/path/to/file.txt');
+    assert.strictEqual(result.type, 'unknown');
+  });
+});
+
+describe('Add Command - Slug Generation', () => {
+  test('generates slug from name', () => {
+    const pbix = require('../utils/pbix');
+
+    assert.strictEqual(pbix.generateSlug('Sales Dashboard Q4'), 'sales-dashboard-q4');
+    assert.strictEqual(pbix.generateSlug('My Report!'), 'my-report');
+    assert.strictEqual(pbix.generateSlug('Budget 2026'), 'budget-2026');
+  });
+
+  test('handles special characters', () => {
+    const pbix = require('../utils/pbix');
+
+    assert.strictEqual(pbix.generateSlug('Report (Final)'), 'report-final');
+    assert.strictEqual(pbix.generateSlug('Test & Demo'), 'test-demo');
+  });
+
+  test('limits slug length', () => {
+    const pbix = require('../utils/pbix');
+    const longName =
+      'This is a very long project name that should be truncated to a reasonable length';
+    const slug = pbix.generateSlug(longName);
+
+    assert.ok(slug.length <= 50);
+  });
+});