@luquimbo/bi-superpowers 3.1.0 → 3.2.0

package/bin/commands/sync-source.js

@@ -1,418 +0,0 @@
-/**
- * Sync Source Command - Bidirectional Synchronization
- * =====================================================
- *
- * Detects which is newer (repo or original file) and syncs accordingly.
- * Combines pull and push logic with automatic conflict detection.
- *
- * Usage:
- *   super sync                   Sync current project
- *   super sync <project-name>    Sync specific project
- *   super sync --all             Sync all projects
- *
- * @module commands/sync-source
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const profiles = require('../utils/profiles');
-const pbix = require('../utils/pbix');
-const git = require('../utils/git');
-const rl = require('../utils/readline');
-const { getAllProjects, getProject, detectCurrentProject } = require('../utils/projects');
-
-// Using shared readline utilities
-const { createReadline } = rl;
-
-/**
- * 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 sync - Sincronización bidireccional
-
-Detecta automáticamente qué es más nuevo (repo o archivo original)
-y sincroniza en la dirección correcta.
-
-Usage:
-  super sync                   Sync proyecto actual
-  super sync <proyecto>        Sync proyecto específico
-  super sync --all             Sync todos los proyectos
-
-Options:
-  --all, -a        Sincronizar todos los proyectos
-  --force, -f      Forzar sin confirmación
-  --help, -h       Mostrar esta ayuda
-
-Ejemplos:
-  super sync sales-q4
-  super sync --all
-`);
-}
-
-// Note: getAllProjects, getProject, and detectCurrentProject are imported from ../utils/projects
-
-/**
- * Determine sync direction based on timestamps and hashes
- * @param {Object} project - Project config
- * @returns {Object} Sync info { direction, reason, sourceModified, repoModified }
- */
-function determineSyncDirection(project) {
-  const result = {
-    direction: 'none', // 'pull', 'push', 'conflict', 'none'
-    reason: '',
-    sourceModified: null,
-    repoModified: null,
-    hasChanges: false,
-  };
-
-  const sourcePath = project.source?.path;
-  if (!sourcePath || !fs.existsSync(sourcePath)) {
-    result.reason = 'Archivo original no encontrado';
-    return result;
-  }
-
-  // Get source file modification time
-  const sourceStats = fs.statSync(sourcePath);
-  result.sourceModified = sourceStats.mtime;
-
-  // Get repo definition modification time
-  const definitionPath = path.join(project.projectPath, 'definition');
-  if (fs.existsSync(definitionPath)) {
-    const repoFiles = pbix.getAllFiles(definitionPath);
-    if (repoFiles.length > 0) {
-      // Find most recent repo file
-      let latestRepoTime = new Date(0);
-      for (const file of repoFiles) {
-        const stats = fs.statSync(file);
-        if (stats.mtime > latestRepoTime) {
-          latestRepoTime = stats.mtime;
-        }
-      }
-      result.repoModified = latestRepoTime;
-    }
-  }
-
-  // Get last sync time
-  const lastSync = project.source?.lastSync ? new Date(project.source.lastSync) : null;
-
-  // Determine direction
-  if (!result.repoModified) {
-    // No repo content yet, need to pull
-    result.direction = 'pull';
-    result.reason = 'Repo vacío - necesita pull inicial';
-    result.hasChanges = true;
-  } else if (!lastSync) {
-    // Never synced, check which is newer
-    if (result.sourceModified > result.repoModified) {
-      result.direction = 'pull';
-      result.reason = 'Archivo original más nuevo (nunca sincronizado)';
-      result.hasChanges = true;
-    } else if (result.repoModified > result.sourceModified) {
-      result.direction = 'push';
-      result.reason = 'Repo más nuevo (nunca sincronizado)';
-      result.hasChanges = true;
-    }
-  } else {
-    // Check what changed since last sync
-    const sourceChangedSinceSync = result.sourceModified > lastSync;
-    const repoChangedSinceSync = result.repoModified > lastSync;
-
-    if (sourceChangedSinceSync && repoChangedSinceSync) {
-      result.direction = 'conflict';
-      result.reason = 'Ambos modificados desde último sync';
-      result.hasChanges = true;
-    } else if (sourceChangedSinceSync) {
-      result.direction = 'pull';
-      result.reason = 'Archivo original modificado';
-      result.hasChanges = true;
-    } else if (repoChangedSinceSync) {
-      result.direction = 'push';
-      result.reason = 'Repo modificado';
-      result.hasChanges = true;
-    } else {
-      result.direction = 'none';
-      result.reason = 'Sin cambios desde último sync';
-      result.hasChanges = false;
-    }
-  }
-
-  return result;
-}
-
-/**
- * Execute pull for a project
- * @param {Object} project - Project config
- * @returns {Object} Result
- */
-function executePull(project) {
-  const result = { success: false, message: '', filesChanged: 0 };
-
-  if (project.type === 'power-bi-project') {
-    const extractResult = pbix.extractPbipToRepo(project.source.path, project.projectPath);
-
-    if (extractResult.success) {
-      // Update project.json
-      project.source.lastSync = new Date().toISOString();
-      project.source.hash = pbix.getFileHash(project.source.path);
-
-      const configPath = path.join(project.projectPath, 'project.json');
-      fs.writeFileSync(configPath, JSON.stringify(project, null, 2));
-
-      result.success = true;
-      result.filesChanged = extractResult.files.length;
-      result.message = `Pulled ${extractResult.files.length} files`;
-    } else {
-      result.message = extractResult.error;
-    }
-  } else {
-    result.message = `Pull no soportado para tipo: ${project.type}`;
-  }
-
-  return result;
-}
-
-/**
- * Execute push for a project
- * @param {Object} project - Project config
- * @returns {Object} Result
- */
-function executePush(project) {
-  const result = { success: false, message: '', filesChanged: 0 };
-
-  if (project.type === 'power-bi-project') {
-    const definitionPath = pbix.getPbipDefinitionPath(project.source.path);
-    const repoDefinition = path.join(project.projectPath, 'definition');
-
-    if (!definitionPath) {
-      result.message = 'No se encontró carpeta definition en PBIP';
-      return result;
-    }
-
-    if (!fs.existsSync(repoDefinition)) {
-      result.message = 'No hay definition en el repo';
-      return result;
-    }
-
-    try {
-      const files = pbix.copyDirectoryRecursive(repoDefinition, definitionPath);
-
-      // Update project.json
-      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.filesChanged = files.length;
-      result.message = `Pushed ${files.length} files`;
-    } catch (e) {
-      result.message = e.message;
-    }
-  } else {
-    result.message = `Push no soportado para tipo: ${project.type}`;
-  }
-
-  return result;
-}
-
-/**
- * Sync a single project
- * @param {Object} project - Project config
- * @param {Object} options - Sync options
- * @param {readline.Interface} rl - Readline interface for prompts
- * @returns {Promise<Object>} Sync result
- */
-async function syncProject(project, options, rl) {
-  const syncInfo = determineSyncDirection(project);
-
-  console.log(`\n  ${project.name}`);
-  console.log(`    Tipo: ${project.type}`);
-  console.log(`    Original: ${project.source?.path || 'No configurado'}`);
-  console.log(`    Estado: ${syncInfo.reason}`);
-
-  if (!syncInfo.hasChanges) {
-    console.log('    → Sin cambios necesarios');
-    return { synced: false, direction: 'none' };
-  }
-
-  if (syncInfo.direction === 'conflict') {
-    console.log('    ⚠ CONFLICTO: Ambos han sido modificados');
-
-    if (!options.force) {
-      const answer = await new Promise((resolve) => {
-        rl.question('    ¿Qué hacer? (pull/push/skip): ', resolve);
-      });
-
-      if (answer === 'pull') {
-        syncInfo.direction = 'pull';
-      } else if (answer === 'push') {
-        syncInfo.direction = 'push';
-      } else {
-        console.log('    → Omitido');
-        return { synced: false, direction: 'skip' };
-      }
-    } else {
-      // Force mode defaults to pull (safer)
-      syncInfo.direction = 'pull';
-      console.log('    → Forzando pull (más seguro)');
-    }
-  }
-
-  let result;
-  if (syncInfo.direction === 'pull') {
-    console.log('    → Ejecutando pull...');
-    result = executePull(project);
-  } else if (syncInfo.direction === 'push') {
-    console.log('    → Ejecutando push...');
-    result = executePush(project);
-  }
-
-  if (result.success) {
-    console.log(`    ✓ ${result.message}`);
-    return { synced: true, direction: syncInfo.direction, filesChanged: result.filesChanged };
-  } else {
-    console.log(`    ✗ ${result.message}`);
-    return { synced: false, direction: syncInfo.direction, error: result.message };
-  }
-}
-
-/**
- * Main sync command handler
- */
-async function syncSourceCommand(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(`
-════════════════════════════════════════════════════════════════
-  Sync - Sincronización Bidireccional
-════════════════════════════════════════════════════════════════
-
-Repositorio: ${repoPath}
-`);
-
-  // Get projects to sync
-  let projects = [];
-
-  if (options.all) {
-    projects = getAllProjects(repoPath);
-    if (projects.length === 0) {
-      console.log('No hay proyectos en el repo.\n');
-      console.log('Añade uno con: super add "ruta/archivo.pbix"');
-      return;
-    }
-    console.log(`Sincronizando ${projects.length} proyecto(s)...`);
-  } else if (options.projectName) {
-    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);
-    }
-    projects = [project];
-  } else {
-    const current = detectCurrentProject(repoPath);
-    if (current) {
-      projects = [current];
-    } else {
-      // Show all projects status
-      projects = getAllProjects(repoPath);
-      if (projects.length === 0) {
-        console.log('No hay proyectos en el repo.\n');
-        console.log('Añade uno con: super add "ruta/archivo.pbix"');
-        return;
-      }
-      console.log('Estado de todos los proyectos:');
-    }
-  }
-
-  // Create readline interface
-  const rlInterface = createReadline();
-
-  // Sync each project
-  let syncedCount = 0;
-  let totalFilesChanged = 0;
-
-  for (const project of projects) {
-    const result = await syncProject(project, options, rlInterface);
-    if (result.synced) {
-      syncedCount++;
-      totalFilesChanged += result.filesChanged || 0;
-    }
-  }
-
-  rlInterface.close();
-
-  // Commit changes if any
-  if (syncedCount > 0 && git.isGitRepo(repoPath)) {
-    console.log('\nCommiteando cambios...');
-    git.stageFiles(repoPath, '.');
-    const projectNames = projects
-      .filter((p) => p)
-      .map((p) => p.name)
-      .join(', ');
-    git.commit(repoPath, `Sync: ${projectNames}`);
-    console.log('✓ Cambios commiteados');
-  }
-
-  console.log(`
-════════════════════════════════════════════════════════════════
-  Resumen
-════════════════════════════════════════════════════════════════
-
-  Proyectos sincronizados: ${syncedCount}/${projects.length}
-  Archivos cambiados: ${totalFilesChanged}
-`);
-}
-
-module.exports = syncSourceCommand;

package/bin/commands/sync-source.test.js

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

package/bin/utils/errors.js

@@ -1,159 +0,0 @@
-/**
- * Error Handling Utilities
- * ========================
- *
- * Standardized error handling for the CLI.
- * Provides consistent error messages and exit codes.
- *
- * @module utils/errors
- */
-
-/**
- * Custom CLI Error class
- * Extends Error with exit code and optional suggestion
- */
-class CLIError extends Error {
-  /**
-   * Create a CLI error
-   * @param {string} message - Error message
-   * @param {number} code - Exit code (default: 1)
-   * @param {string|null} suggestion - Optional suggestion for fixing the error
-   */
-  constructor(message, code = 1, suggestion = null) {
-    super(message);
-    this.name = 'CLIError';
-    this.code = code;
-    this.suggestion = suggestion;
-  }
-}
-
-/**
- * Error codes for common scenarios
- */
-const ErrorCodes = {
-  GENERAL: 1,
-  INVALID_INPUT: 2,
-  FILE_NOT_FOUND: 3,
-  PERMISSION_DENIED: 4,
-  NETWORK_ERROR: 5,
-  CONFIG_ERROR: 6,
-  GIT_ERROR: 7,
-  VALIDATION_ERROR: 8,
-};
-
-/**
- * Handle an error with consistent formatting
- * @param {Error} error - The error to handle
- * @param {Object} options - Options for handling
- * @param {boolean} options.exit - Whether to exit the process (default: true)
- * @param {boolean} options.verbose - Show stack trace (default: false)
- */
-function handleError(error, options = {}) {
-  const { exit = true, verbose = process.env.DEBUG === 'true' } = options;
-
-  if (error instanceof CLIError) {
-    console.error(`Error: ${error.message}`);
-    if (error.suggestion) {
-      console.error(`\nSuggestion: ${error.suggestion}`);
-    }
-    if (exit) {
-      process.exit(error.code);
-    }
-  } else if (error instanceof Error) {
-    console.error(`Error: ${error.message}`);
-    if (verbose && error.stack) {
-      console.error(`\nStack trace:\n${error.stack}`);
-    }
-    if (exit) {
-      process.exit(ErrorCodes.GENERAL);
-    }
-  } else {
-    console.error(`Error: ${String(error)}`);
-    if (exit) {
-      process.exit(ErrorCodes.GENERAL);
-    }
-  }
-}
-
-/**
- * Wrap an async function with error handling
- * @param {Function} fn - Async function to wrap
- * @param {Object} options - Error handling options
- * @returns {Function} Wrapped function
- */
-function withErrorHandling(fn, options = {}) {
-  return async (...args) => {
-    try {
-      return await fn(...args);
-    } catch (error) {
-      handleError(error, options);
-    }
-  };
-}
-
-/**
- * Log a warning without exiting
- * @param {string} message - Warning message
- * @param {Object} context - Additional context (optional)
- */
-function logWarning(message, context = null) {
-  console.warn(`Warning: ${message}`);
-  if (context && process.env.DEBUG === 'true') {
-    console.warn('Context:', context);
-  }
-}
-
-/**
- * Create a CLIError for common scenarios
- */
-const createError = {
-  fileNotFound: (path) =>
-    new CLIError(
-      `File not found: ${path}`,
-      ErrorCodes.FILE_NOT_FOUND,
-      'Check that the file path is correct.'
-    ),
-
-  invalidInput: (message, suggestion = null) =>
-    new CLIError(message, ErrorCodes.INVALID_INPUT, suggestion),
-
-  configError: (message) =>
-    new CLIError(
-      message,
-      ErrorCodes.CONFIG_ERROR,
-      'Run "bi-superpowers setup" to configure the repository.'
-    ),
-
-  gitError: (message) =>
-    new CLIError(
-      message,
-      ErrorCodes.GIT_ERROR,
-      'Make sure Git is installed and you are in a Git repository.'
-    ),
-
-  networkError: (message) =>
-    new CLIError(
-      message,
-      ErrorCodes.NETWORK_ERROR,
-      'Check your internet connection and try again.'
-    ),
-
-  permissionDenied: (path) =>
-    new CLIError(
-      `Permission denied: ${path}`,
-      ErrorCodes.PERMISSION_DENIED,
-      'Check file permissions.'
-    ),
-
-  validationError: (message, suggestion = null) =>
-    new CLIError(message, ErrorCodes.VALIDATION_ERROR, suggestion),
-};
-
-module.exports = {
-  CLIError,
-  ErrorCodes,
-  handleError,
-  withErrorHandling,
-  logWarning,
-  createError,
-};