@luquimbo/bi-superpowers 3.1.1 → 4.1.0

package/bin/utils/git.js

@@ -1,298 +0,0 @@
-/**
- * Git Utilities for BI Agent Superpowers
- * =======================================
- *
- * Provides Git operations for the multi-project repo system.
- * Uses simple-git for robust cross-platform Git operations.
- *
- * @module utils/git
- */
-
-const { execSync, spawnSync } = require('child_process');
-
-/**
- * Check if Git is installed on the system
- * @returns {boolean} True if Git is available
- */
-function isGitInstalled() {
-  try {
-    execSync('git --version', { stdio: 'pipe' });
-    return true;
-  } catch (e) {
-    return false;
-  }
-}
-
-/**
- * Check if a directory is a Git repository
- * @param {string} dir - Directory path to check
- * @returns {boolean} True if directory is a Git repo
- */
-function isGitRepo(dir) {
-  try {
-    const result = spawnSync('git', ['rev-parse', '--git-dir'], {
-      cwd: dir,
-      stdio: 'pipe',
-    });
-    return result.status === 0;
-  } catch (e) {
-    return false;
-  }
-}
-
-/**
- * Initialize a new Git repository
- * @param {string} dir - Directory to initialize
- * @returns {boolean} True if successful
- */
-function initRepo(dir) {
-  try {
-    const result = spawnSync('git', ['init'], {
-      cwd: dir,
-      stdio: 'pipe',
-    });
-    return result.status === 0;
-  } catch (e) {
-    return false;
-  }
-}
-
-/**
- * Stage files in Git
- * @param {string} dir - Repository directory
- * @param {string|string[]} files - Files to stage (use '.' for all)
- * @returns {boolean} True if successful
- */
-function stageFiles(dir, files = '.') {
-  try {
-    const fileArgs = Array.isArray(files) ? files : [files];
-    const result = spawnSync('git', ['add', ...fileArgs], {
-      cwd: dir,
-      stdio: 'pipe',
-    });
-    return result.status === 0;
-  } catch (e) {
-    return false;
-  }
-}
-
-/**
- * Create a Git commit
- * @param {string} dir - Repository directory
- * @param {string} message - Commit message
- * @returns {boolean} True if successful
- */
-function commit(dir, message) {
-  try {
-    const result = spawnSync('git', ['commit', '-m', message], {
-      cwd: dir,
-      stdio: 'pipe',
-    });
-    return result.status === 0;
-  } catch (e) {
-    return false;
-  }
-}
-
-/**
- * Get the current branch name
- * @param {string} dir - Repository directory
- * @returns {string|null} Branch name or null if not in a repo
- */
-function getCurrentBranch(dir) {
-  try {
-    const result = spawnSync('git', ['branch', '--show-current'], {
-      cwd: dir,
-      stdio: 'pipe',
-    });
-    if (result.status === 0) {
-      return result.stdout.toString().trim();
-    }
-    return null;
-  } catch (e) {
-    return null;
-  }
-}
-
-/**
- * Get the status of the repository
- * @param {string} dir - Repository directory
- * @returns {Object} Status object with modified, staged, untracked files
- */
-function getStatus(dir) {
-  try {
-    const result = spawnSync('git', ['status', '--porcelain'], {
-      cwd: dir,
-      stdio: 'pipe',
-    });
-
-    if (result.status !== 0) {
-      return { modified: [], staged: [], untracked: [] };
-    }
-
-    const lines = result.stdout.toString().trim().split('\n').filter(Boolean);
-    const status = { modified: [], staged: [], untracked: [] };
-
-    for (const line of lines) {
-      const code = line.substring(0, 2);
-      const file = line.substring(3);
-
-      if (code.includes('?')) {
-        status.untracked.push(file);
-      } else if (code[0] !== ' ') {
-        status.staged.push(file);
-      } else if (code[1] !== ' ') {
-        status.modified.push(file);
-      }
-    }
-
-    return status;
-  } catch (e) {
-    return { modified: [], staged: [], untracked: [] };
-  }
-}
-
-/**
- * Get commit log
- * @param {string} dir - Repository directory
- * @param {number} count - Number of commits to retrieve
- * @returns {Array} Array of commit objects
- */
-function getLog(dir, count = 10) {
-  try {
-    const result = spawnSync(
-      'git',
-      ['log', `--max-count=${count}`, '--pretty=format:%H|%s|%ai|%an'],
-      {
-        cwd: dir,
-        stdio: 'pipe',
-      }
-    );
-
-    if (result.status !== 0) {
-      return [];
-    }
-
-    const lines = result.stdout.toString().trim().split('\n').filter(Boolean);
-    return lines.map((line) => {
-      const [hash, subject, date, author] = line.split('|');
-      return { hash, subject, date, author };
-    });
-  } catch (e) {
-    return [];
-  }
-}
-
-/**
- * Check if there are uncommitted changes
- * @param {string} dir - Repository directory
- * @returns {boolean} True if there are uncommitted changes
- */
-function hasUncommittedChanges(dir) {
-  const status = getStatus(dir);
-  return status.modified.length > 0 || status.staged.length > 0 || status.untracked.length > 0;
-}
-
-/**
- * Checkout a specific commit or branch
- * @param {string} dir - Repository directory
- * @param {string} ref - Reference to checkout (commit hash, branch, tag)
- * @returns {boolean} True if successful
- */
-function checkout(dir, ref) {
-  try {
-    const result = spawnSync('git', ['checkout', ref], {
-      cwd: dir,
-      stdio: 'pipe',
-    });
-    return result.status === 0;
-  } catch (e) {
-    return false;
-  }
-}
-
-/**
- * Get diff between two commits or current changes
- * @param {string} dir - Repository directory
- * @param {string} from - Starting reference (optional)
- * @param {string} to - Ending reference (optional)
- * @returns {string} Diff output
- */
-function getDiff(dir, from = null, to = null) {
-  try {
-    const args = ['diff'];
-    if (from) args.push(from);
-    if (to) args.push(to);
-
-    const result = spawnSync('git', args, {
-      cwd: dir,
-      stdio: 'pipe',
-    });
-
-    return result.stdout.toString();
-  } catch (e) {
-    return '';
-  }
-}
-
-/**
- * Execute a raw Git command and return output
- * @param {string} dir - Repository directory
- * @param {string[]} args - Git command arguments
- * @returns {string|null} Command output or null on failure
- */
-function execGitCommand(dir, args) {
-  try {
-    const result = spawnSync('git', args, {
-      cwd: dir,
-      stdio: 'pipe',
-      maxBuffer: 1024 * 1024 * 10, // 10MB buffer for large outputs
-    });
-
-    if (result.status === 0) {
-      return result.stdout.toString();
-    }
-    return null;
-  } catch (e) {
-    return null;
-  }
-}
-
-/**
- * Get file modification date from last commit
- * @param {string} dir - Repository directory
- * @param {string} filePath - Path to file relative to repo root
- * @returns {Date|null} Last modification date or null
- */
-function getFileLastModified(dir, filePath) {
-  try {
-    const result = spawnSync('git', ['log', '-1', '--format=%ai', '--', filePath], {
-      cwd: dir,
-      stdio: 'pipe',
-    });
-
-    if (result.status === 0) {
-      const dateStr = result.stdout.toString().trim();
-      return dateStr ? new Date(dateStr) : null;
-    }
-    return null;
-  } catch (e) {
-    return null;
-  }
-}
-
-module.exports = {
-  isGitInstalled,
-  isGitRepo,
-  initRepo,
-  stageFiles,
-  commit,
-  getCurrentBranch,
-  getStatus,
-  getLog,
-  hasUncommittedChanges,
-  checkout,
-  getDiff,
-  execGitCommand,
-  getFileLastModified,
-};

package/bin/utils/logger.js

@@ -1,142 +0,0 @@
-/**
- * Logger Utility
- * ===============
- *
- * Standardized logging for the CLI with log levels.
- * Respects LOG_LEVEL environment variable.
- *
- * Usage:
- *   const logger = require('./utils/logger');
- *   logger.debug('Debug message', { context: 'optional' });
- *   logger.info('Info message');
- *   logger.warn('Warning message');
- *   logger.error('Error message');
- *
- * Environment:
- *   LOG_LEVEL=debug|info|warn|error (default: info)
- *   DEBUG=true (shorthand for LOG_LEVEL=debug)
- *
- * @module utils/logger
- */
-
-const LOG_LEVELS = {
-  debug: 0,
-  info: 1,
-  warn: 2,
-  error: 3,
-  silent: 4,
-};
-
-/**
- * Get current log level from environment
- * @returns {string} Current log level
- */
-function getCurrentLevel() {
-  if (process.env.DEBUG === 'true') {
-    return 'debug';
-  }
-  return process.env.LOG_LEVEL || 'info';
-}
-
-/**
- * Check if a log level should be shown
- * @param {string} level - Level to check
- * @returns {boolean} Whether to show this level
- */
-function shouldLog(level) {
-  const currentLevel = getCurrentLevel();
-  return LOG_LEVELS[level] >= LOG_LEVELS[currentLevel];
-}
-
-/**
- * Format a log message with optional context
- * @param {string} prefix - Log level prefix
- * @param {string} message - Log message
- * @param {Object|null} context - Optional context object
- * @returns {string} Formatted message
- */
-function formatMessage(prefix, message, context) {
-  let formatted = `[${prefix}] ${message}`;
-  if (context !== null && context !== undefined) {
-    if (typeof context === 'object') {
-      formatted += ` ${JSON.stringify(context)}`;
-    } else {
-      formatted += ` ${context}`;
-    }
-  }
-  return formatted;
-}
-
-/**
- * Debug level logging
- * Only shown when LOG_LEVEL=debug or DEBUG=true
- * @param {string} message - Log message
- * @param {Object|null} context - Optional context
- */
-function debug(message, context = null) {
-  if (shouldLog('debug')) {
-    console.log(formatMessage('DEBUG', message, context));
-  }
-}
-
-/**
- * Info level logging
- * Standard informational messages
- * @param {string} message - Log message
- * @param {Object|null} context - Optional context
- */
-function info(message, context = null) {
-  if (shouldLog('info')) {
-    console.log(formatMessage('INFO', message, context));
-  }
-}
-
-/**
- * Warning level logging
- * Non-critical issues that should be noticed
- * @param {string} message - Log message
- * @param {Object|null} context - Optional context
- */
-function warn(message, context = null) {
-  if (shouldLog('warn')) {
-    console.warn(formatMessage('WARN', message, context));
-  }
-}
-
-/**
- * Error level logging
- * Critical errors that affect operation
- * @param {string} message - Log message
- * @param {Object|null} context - Optional context
- */
-function error(message, context = null) {
-  if (shouldLog('error')) {
-    console.error(formatMessage('ERROR', message, context));
-  }
-}
-
-/**
- * Create a child logger with a prefix
- * Useful for module-specific logging
- * @param {string} prefix - Prefix for all messages
- * @returns {Object} Logger instance with prefix
- */
-function createLogger(prefix) {
-  return {
-    debug: (msg, ctx) => debug(`[${prefix}] ${msg}`, ctx),
-    info: (msg, ctx) => info(`[${prefix}] ${msg}`, ctx),
-    warn: (msg, ctx) => warn(`[${prefix}] ${msg}`, ctx),
-    error: (msg, ctx) => error(`[${prefix}] ${msg}`, ctx),
-  };
-}
-
-module.exports = {
-  LOG_LEVELS,
-  debug,
-  info,
-  warn,
-  error,
-  createLogger,
-  getCurrentLevel,
-  shouldLog,
-};

package/bin/utils/mcp-detect.test.js

@@ -1,81 +0,0 @@
-/**
- * Tests for MCP Detection Utilities
- * @module utils/mcp-detect.test
- */
-
-const { test, describe } = require('node:test');
-const assert = require('node:assert');
-
-const mcpDetect = require('./mcp-detect');
-
-describe('MCP Detection Utilities', () => {
-  test('exports expected functions', () => {
-    assert.strictEqual(typeof mcpDetect.findLocalMcp, 'function');
-    assert.strictEqual(typeof mcpDetect.getMcpVersion, 'function');
-    assert.strictEqual(typeof mcpDetect.getMcpStatus, 'function');
-    assert.strictEqual(typeof mcpDetect.getInstallInstructions, 'function');
-    assert.strictEqual(typeof mcpDetect.generateMcpConfig, 'function');
-    assert.strictEqual(typeof mcpDetect.getExplicitMcpPath, 'function');
-    assert.strictEqual(typeof mcpDetect.getModelingMcpError, 'function');
-  });
-
-  test('exports env vars for local MCP path override', () => {
-    assert.ok(Array.isArray(mcpDetect.MODELING_MCP_ENV_VARS));
-    assert.ok(mcpDetect.MODELING_MCP_ENV_VARS.includes('BI_SUPERPOWERS_POWERBI_MODELING_MCP_PATH'));
-  });
-});
-
-describe('getMcpStatus', () => {
-  test('returns expected structure for the local MCP only', () => {
-    const status = mcpDetect.getMcpStatus();
-
-    assert.ok(status.local);
-    assert.ok('installed' in status.local);
-    assert.ok('path' in status.local);
-    assert.ok('version' in status.local);
-    assert.ok('platform' in status.local);
-    assert.ok('available' in status.local);
-    assert.ok(Array.isArray(status.local.envVars));
-  });
-});
-
-describe('getInstallInstructions', () => {
-  test('returns expected structure', () => {
-    const instructions = mcpDetect.getInstallInstructions();
-
-    assert.ok(instructions.title);
-    assert.ok(Array.isArray(instructions.options));
-    assert.ok(instructions.options.length > 0);
-
-    instructions.options.forEach((option) => {
-      assert.ok(option.name);
-      assert.ok(Array.isArray(option.steps));
-      assert.ok(option.link);
-    });
-  });
-});
-
-describe('generateMcpConfig', () => {
-  test('generates plugin format with 2 official Microsoft MCPs', () => {
-    const config = mcpDetect.generateMcpConfig({}, 'plugin');
-
-    assert.ok(config['powerbi-modeling-mcp']);
-    assert.ok(config['microsoft-learn']);
-    assert.strictEqual(Object.keys(config).length, 2);
-
-    assert.strictEqual(config['powerbi-modeling-mcp'].type, 'stdio');
-    assert.strictEqual(config['powerbi-modeling-mcp'].command, 'node');
-    assert.ok(config['powerbi-modeling-mcp'].args[0].includes('powerbi-modeling-launcher.js'));
-
-    assert.strictEqual(config['microsoft-learn'].type, 'http');
-    assert.strictEqual(config['microsoft-learn'].url, 'https://learn.microsoft.com/api/mcp');
-  });
-
-  test('generates claude format with nested mcpServers object', () => {
-    const config = mcpDetect.generateMcpConfig({}, 'claude');
-
-    assert.ok(config.mcpServers);
-    assert.ok(config.mcpServers['powerbi-modeling-mcp']);
-    assert.ok(config.mcpServers['microsoft-learn']);
-  });
-});