@luquimbo/bi-superpowers 3.1.1 → 4.1.0

package/bin/commands/add.js

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

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