@luquimbo/bi-superpowers 3.1.0 → 3.2.0

package/bin/commands/pull.js

@@ -1,287 +0,0 @@
-/**
- * Pull Command - Sync from Original to Repo
- * ==========================================
- *
- * Pulls changes from the original BI file to the repo.
- * Extracts updated TMDL/content and creates a Git commit.
- *
- * Usage:
- *   super pull                   Pull current project
- *   super pull <project-name>    Pull specific project
- *   super pull --all             Pull all projects
- *
- * @module commands/pull
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const git = require('../utils/git');
-const profiles = require('../utils/profiles');
-const pbix = require('../utils/pbix');
-const { getAllProjects, getProject, detectCurrentProject } = require('../utils/projects');
-
-/**
- * Parse command line arguments
- * @param {string[]} args - CLI arguments
- * @returns {Object} Parsed options
- */
-function parseArgs(args) {
-  const options = {
-    projectName: null,
-    all: false,
-    force: false,
-    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 === '--force' || arg === '-f') {
-      options.force = true;
-    } else if (arg === '--help' || arg === '-h') {
-      options.help = true;
-    } else if (!arg.startsWith('-') && !options.projectName) {
-      options.projectName = arg;
-    }
-  }
-
-  return options;
-}
-
-/**
- * Show help message
- */
-function showHelp() {
-  console.log(`
-super pull - Traer cambios del archivo original al repo
-
-Uso:
-  super pull                   Pull del proyecto actual (si estás en la carpeta)
-  super pull <nombre-proyecto> Pull de un proyecto específico
-  super pull --all             Pull de todos los proyectos
-
-Opciones:
-  --all, -a        Pull de todos los proyectos
-  --force, -f      Forzar pull aunque no haya cambios detectados
-  --help, -h       Mostrar esta ayuda
-
-Ejemplos:
-  super pull sales-q4
-  super pull --all
-  super pull hr-dashboard --force
-`);
-}
-
-// Note: getAllProjects, getProject, and detectCurrentProject are imported from ../utils/projects
-
-/**
- * Pull changes for a single project
- * @param {Object} project - Project config
- * @param {boolean} force - Force pull even if no changes
- * @returns {Object} Result object
- */
-function pullProject(project, force = false) {
-  const result = {
-    success: false,
-    project: project.name,
-    message: '',
-    filesChanged: 0,
-  };
-
-  // Check if source file exists
-  const sourcePath = project.source?.path;
-  if (!sourcePath || !fs.existsSync(sourcePath)) {
-    result.message = `Archivo original no encontrado: ${sourcePath || 'no configurado'}`;
-    return result;
-  }
-
-  // Check if file has changed (by modification time or hash)
-  const currentHash = pbix.getFileHash(sourcePath);
-  const lastHash = project.source?.hash || '';
-
-  if (currentHash === lastHash && !force) {
-    result.success = true;
-    result.message = 'Sin cambios';
-    return result;
-  }
-
-  // Detect file type and extract
-  const fileInfo = pbix.detectFileType(sourcePath);
-
-  if (fileInfo.type === 'power-bi-project') {
-    // PBIP - extract TMDL
-    const definitionPath = pbix.getPbipDefinitionPath(sourcePath);
-
-    if (definitionPath) {
-      const targetDef = path.join(project.projectPath, 'definition');
-
-      // Compare directories to show changes
-      const changes = pbix.compareDirectories(targetDef, definitionPath);
-
-      // Copy new content
-      const extraction = pbix.extractPbipToRepo(sourcePath, project.projectPath);
-
-      if (extraction.success) {
-        result.success = true;
-        result.filesChanged =
-          changes.added.length + changes.modified.length + changes.deleted.length;
-        result.message = `Actualizado: +${changes.added.length} ~${changes.modified.length} -${changes.deleted.length}`;
-      } else {
-        result.message = extraction.error;
-      }
-    } else {
-      result.message = 'No se encontró carpeta definition en PBIP';
-    }
-  } else if (fileInfo.type === 'power-bi') {
-    // PBIX - just update modification time and hash
-    result.success = true;
-    result.message = 'Archivo .pbix actualizado (binario, sin diff detallado)';
-
-    // Update the README with latest info
-    const readmePath = path.join(project.projectPath, 'README.md');
-    if (fs.existsSync(readmePath)) {
-      let content = fs.readFileSync(readmePath, 'utf8');
-      const lastMod = pbix.getLastModified(sourcePath);
-
-      // Add update note
-      if (!content.includes('## Historial de Actualizaciones')) {
-        content += '\n\n## Historial de Actualizaciones\n';
-      }
-      content += `\n- ${lastMod?.toISOString()}: Pull desde archivo original`;
-      fs.writeFileSync(readmePath, content);
-    }
-  } else if (fileInfo.type === 'excel' || fileInfo.type === 'excel-macro') {
-    // Excel - update modification tracking
-    result.success = true;
-    result.message = 'Archivo Excel actualizado';
-  } else {
-    result.message = 'Tipo de archivo no soportado para pull';
-  }
-
-  // Update project.json with new hash and sync time
-  if (result.success) {
-    project.source.hash = currentHash;
-    project.source.lastSync = new Date().toISOString();
-
-    const configPath = path.join(project.projectPath, 'project.json');
-    fs.writeFileSync(configPath, JSON.stringify(project, null, 2));
-  }
-
-  return result;
-}
-
-/**
- * Main pull command handler
- */
-async function pullCommand(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
-`);
-    process.exit(1);
-  }
-
-  console.log(`
-════════════════════════════════════════════════════════════════
-  Pull - Traer cambios de archivos originales
-════════════════════════════════════════════════════════════════
-`);
-
-  let projectsToPull = [];
-
-  if (options.all) {
-    // Pull all projects
-    projectsToPull = getAllProjects(repoPath);
-    console.log(`Proyectos encontrados: ${projectsToPull.length}\n`);
-  } else if (options.projectName) {
-    // Pull specific project
-    const project = getProject(repoPath, options.projectName);
-    if (!project) {
-      console.log(`✗ Proyecto no encontrado: ${options.projectName}`);
-      console.log('\nProyectos disponibles:');
-      getAllProjects(repoPath).forEach((p) => {
-        console.log(`  - ${p.name}`);
-      });
-      process.exit(1);
-    }
-    projectsToPull = [project];
-  } else {
-    // Try to detect current project
-    const current = detectCurrentProject(repoPath);
-    if (current) {
-      projectsToPull = [current];
-    } else {
-      // No project specified, show help
-      console.log('Especifica un proyecto o usa --all:\n');
-      console.log('  super pull <nombre-proyecto>');
-      console.log('  super pull --all\n');
-      console.log('Proyectos disponibles:');
-      getAllProjects(repoPath).forEach((p) => {
-        console.log(`  - ${p.name}`);
-      });
-      return;
-    }
-  }
-
-  if (projectsToPull.length === 0) {
-    console.log('No hay proyectos para actualizar.');
-    return;
-  }
-
-  // Pull each project
-  const results = [];
-
-  for (const project of projectsToPull) {
-    process.stdout.write(`  ${project.name}... `);
-
-    const result = pullProject(project, options.force);
-    results.push(result);
-
-    if (result.success) {
-      console.log(`✓ ${result.message}`);
-    } else {
-      console.log(`✗ ${result.message}`);
-    }
-  }
-
-  // Git commit if there were changes
-  const changedProjects = results.filter((r) => r.success && r.filesChanged > 0);
-
-  if (changedProjects.length > 0 && git.isGitRepo(repoPath)) {
-    console.log('\nGuardando cambios en Git...');
-
-    git.stageFiles(repoPath, '.');
-
-    const projectNames = changedProjects.map((r) => r.project).join(', ');
-    git.commit(repoPath, `Pull updates: ${projectNames}`);
-
-    console.log(`  ✓ Commit: "Pull updates: ${projectNames}"`);
-  }
-
-  // Summary
-  const successful = results.filter((r) => r.success).length;
-  const failed = results.filter((r) => !r.success).length;
-
-  console.log(`
-════════════════════════════════════════════════════════════════
-  Resumen: ${successful} exitosos, ${failed} fallidos
-════════════════════════════════════════════════════════════════
-`);
-}
-
-module.exports = pullCommand;

package/bin/commands/pull.test.js

@@ -1,36 +0,0 @@
-/**
- * Tests for Pull Command
- * @module commands/pull.test
- */
-
-const { test, describe } = require('node:test');
-const assert = require('node:assert');
-
-describe('Pull Command', () => {
-  test('module exports a function', () => {
-    const pullCommand = require('./pull');
-    assert.strictEqual(typeof pullCommand, 'function');
-  });
-});
-
-describe('Pull Command - Directory Comparison', () => {
-  test('compareDirectories returns diff structure', () => {
-    const pbix = require('../utils/pbix');
-
-    // Test with non-existent directories (should return empty diff)
-    const result = pbix.compareDirectories('/non/existent/dir1', '/non/existent/dir2');
-
-    assert.ok(Array.isArray(result.added));
-    assert.ok(Array.isArray(result.modified));
-    assert.ok(Array.isArray(result.deleted));
-  });
-});
-
-describe('Pull Command - File Hashing', () => {
-  test('getFileHash returns empty string for non-existent file', () => {
-    const pbix = require('../utils/pbix');
-    const result = pbix.getFileHash('/non/existent/file.txt');
-
-    assert.strictEqual(result, '');
-  });
-});

package/bin/commands/push.js

@@ -1,231 +0,0 @@
-/**
- * Push Command - Apply Repo Changes to Original File
- * ====================================================
- *
- * Pushes changes from the repo back to the original BI file.
- * This is a Phase 2 feature - currently provides guidance for PBIP workflow.
- *
- * Usage:
- *   super push                   Push current project
- *   super push <project-name>    Push specific project
- *
- * @module commands/push
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const profiles = require('../utils/profiles');
-const pbix = require('../utils/pbix');
-const { getAllProjects, getProject, detectCurrentProject } = require('../utils/projects');
-
-/**
- * Parse command line arguments
- * @param {string[]} args - CLI arguments
- * @returns {Object} Parsed options
- */
-function parseArgs(args) {
-  const options = {
-    projectName: null,
-    force: false,
-    help: false,
-  };
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-
-    if (arg === '--force' || arg === '-f') {
-      options.force = true;
-    } else if (arg === '--help' || arg === '-h') {
-      options.help = true;
-    } else if (!arg.startsWith('-') && !options.projectName) {
-      options.projectName = arg;
-    }
-  }
-
-  return options;
-}
-
-/**
- * Show help message
- */
-function showHelp() {
-  console.log(`
-super push - Aplicar cambios del repo al archivo original
-
-Uso:
-  super push                   Push del proyecto actual
-  super push <nombre-proyecto> Push de un proyecto específico
-
-Opciones:
-  --force, -f      Forzar push aunque haya advertencias
-  --help, -h       Mostrar esta ayuda
-
-Nota:
-  Este comando actualmente soporta proyectos PBIP.
-  Para archivos .pbix, usa el workflow PBIP (recomendado).
-
-Ejemplos:
-  super push sales-q4
-  super push --force
-`);
-}
-
-// Note: getAllProjects, getProject, and detectCurrentProject are imported from ../utils/projects
-
-/**
- * Push changes for a PBIP project
- * @param {Object} project - Project config
- * @returns {Object} Result object
- */
-function pushPbipProject(project) {
-  const result = {
-    success: false,
-    message: '',
-  };
-
-  const sourcePath = project.source?.path;
-  if (!sourcePath) {
-    result.message = 'No source path configured';
-    return result;
-  }
-
-  const definitionPath = pbix.getPbipDefinitionPath(sourcePath);
-  if (!definitionPath) {
-    result.message = 'Could not find PBIP definition folder';
-    return result;
-  }
-
-  const repoDefinition = path.join(project.projectPath, 'definition');
-  if (!fs.existsSync(repoDefinition)) {
-    result.message = 'No definition folder in repo';
-    return result;
-  }
-
-  try {
-    // Copy files from repo to PBIP project
-    const files = pbix.copyDirectoryRecursive(repoDefinition, definitionPath);
-
-    // Update project.json with sync time
-    project.source.lastSync = new Date().toISOString();
-    const configPath = path.join(project.projectPath, 'project.json');
-    fs.writeFileSync(configPath, JSON.stringify(project, null, 2));
-
-    result.success = true;
-    result.message = `Pushed ${files.length} files to PBIP project`;
-  } catch (e) {
-    result.message = `Error: ${e.message}`;
-  }
-
-  return result;
-}
-
-/**
- * Main push command handler
- */
-async function pushCommand(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
-`);
-    process.exit(1);
-  }
-
-  console.log(`
-════════════════════════════════════════════════════════════════
-  Push - Aplicar cambios del repo al archivo original
-════════════════════════════════════════════════════════════════
-`);
-
-  let project;
-
-  if (options.projectName) {
-    project = getProject(repoPath, options.projectName);
-    if (!project) {
-      console.log(`✗ Proyecto no encontrado: ${options.projectName}`);
-      console.log('\nProyectos disponibles:');
-      getAllProjects(repoPath).forEach((p) => {
-        console.log(`  - ${p.name}`);
-      });
-      process.exit(1);
-    }
-  } else {
-    project = detectCurrentProject(repoPath);
-    if (!project) {
-      console.log('Especifica un proyecto:\n');
-      console.log('  super push <nombre-proyecto>\n');
-      console.log('Proyectos disponibles:');
-      getAllProjects(repoPath).forEach((p) => {
-        console.log(`  - ${p.name}`);
-      });
-      return;
-    }
-  }
-
-  console.log(`Proyecto: ${project.name}`);
-  console.log(`Tipo: ${project.type}`);
-  console.log(`Archivo original: ${project.source?.path || 'No configurado'}\n`);
-
-  // Handle based on project type
-  if (project.type === 'power-bi-project') {
-    // PBIP - we can push directly
-    const result = pushPbipProject(project);
-
-    if (result.success) {
-      console.log(`✓ ${result.message}`);
-      console.log(`
-Los cambios se han aplicado al proyecto PBIP.
-Abre Power BI Desktop y recarga el proyecto para ver los cambios.
-`);
-    } else {
-      console.log(`✗ ${result.message}`);
-    }
-  } else if (project.type === 'power-bi') {
-    // PBIX - binary file, cannot push directly
-    console.log(`
-⚠ Los archivos .pbix son binarios y no se pueden modificar directamente.
-
-Para aplicar cambios del repo al modelo, tienes estas opciones:
-
-OPCIÓN 1: Convertir a PBIP (Recomendado)
-  1. Abre el .pbix en Power BI Desktop
-  2. File → Save as → Power BI Project (.pbip)
-  3. Ejecuta: super add "ruta/al/proyecto.pbip"
-  4. Los cambios del repo se pueden aplicar con: super push
-
-OPCIÓN 2: Copiar manualmente
-  1. Abre el .pbix en Power BI Desktop
-  2. Copia las medidas/queries del repo manualmente
-  3. Guarda el archivo
-
-Los archivos del repo están en:
-  ${project.projectPath}
-`);
-  } else if (project.type === 'excel' || project.type === 'excel-macro') {
-    console.log(`
-⚠ Los archivos Excel no se pueden modificar automáticamente.
-
-La documentación del workbook está en:
-  ${path.join(project.projectPath, 'workbook')}
-
-Usa esta documentación como referencia para aplicar
-cambios manualmente en Excel.
-`);
-  } else {
-    console.log(`✗ Tipo de proyecto no soportado para push: ${project.type}`);
-  }
-}
-
-module.exports = pushCommand;

package/bin/commands/push.test.js

@@ -1,14 +0,0 @@
-/**
- * Tests for Push Command
- * @module commands/push.test
- */
-
-const { test, describe } = require('node:test');
-const assert = require('node:assert');
-
-describe('Push Command', () => {
-  test('module exports a function', () => {
-    const pushCommand = require('./push');
-    assert.strictEqual(typeof pushCommand, 'function');
-  });
-});