@luquimbo/bi-superpowers 3.1.0 → 3.2.0

package/desktop-extension/server.js

@@ -3,10 +3,11 @@
 /**
  * BI Agent Superpowers — MCP Server for Claude Desktop
  *
- * Lightweight MCP server that exposes all 24 BI skills as prompts.
- * Bundled into a .mcpb extension via `super build-desktop`.
+ * Lightweight MCP server that exposes each bi-superpowers skill as a
+ * Claude Desktop prompt. Bundled into a .mcpb extension via
+ * `super build-desktop`.
  *
- * Skills are loaded from the ./skills/ directory (copied at build time).
+ * Skills are loaded from the ./skills/ directory (copied in at build time).
  */
 
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
@@ -18,29 +19,25 @@ import { fileURLToPath } from 'url';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const skillsDir = path.join(__dirname, 'skills');
 
-// Create the MCP server instance
+// Create the MCP server instance.
 const server = new McpServer({
   name: 'bi-superpowers',
   version: '0.0.0-template',
 });
 
-// Load all skill markdown files from the bundled skills/ directory
+// Load all skill markdown files from the bundled skills/ directory.
 const skillFiles = fs.existsSync(skillsDir)
   ? fs.readdirSync(skillsDir).filter((f) => f.endsWith('.md'))
   : [];
 
-// Register each skill as an MCP prompt that Claude Desktop can invoke
+// Register each skill as an MCP prompt that Claude Desktop can invoke.
 for (const file of skillFiles) {
   const name = path.basename(file, '.md');
   const content = fs.readFileSync(path.join(skillsDir, file), 'utf8');
 
-  // Extract first line as description (skip markdown headers)
-  const firstLine = content
-    .split('\n')
-    .find((l) => l.trim() && !l.startsWith('#'));
-  const description = firstLine
-    ? firstLine.slice(0, 120).trim()
-    : `BI Superpowers: ${name}`;
+  // Use the first non-header line as a short description for the prompt.
+  const firstLine = content.split('\n').find((l) => l.trim() && !l.startsWith('#'));
+  const description = firstLine ? firstLine.slice(0, 120).trim() : `BI Superpowers: ${name}`;
 
   server.prompt(name, { description }, () => ({
     messages: [
@@ -52,10 +49,15 @@ for (const file of skillFiles) {
   }));
 }
 
-// Register a setup-mcp helper prompt with Power BI/Fabric/Excel MCP instructions
+// Register a setup-mcp helper prompt that explains how to wire the
+// official Microsoft MCP servers (Power BI Modeling + Microsoft Learn)
+// into Claude Desktop.
 server.prompt(
   'setup-mcp',
-  { description: 'Instructions to configure Power BI, Fabric & Excel MCP servers in Claude Desktop' },
+  {
+    description:
+      'Instructions to configure the Power BI Modeling and Microsoft Learn MCP servers in Claude Desktop',
+  },
   () => ({
     messages: [
       {
@@ -64,25 +66,32 @@ server.prompt(
           type: 'text',
           text: `# Configure MCP Servers for Claude Desktop
 
-To connect Power BI, Fabric, and Excel to Claude Desktop, add the following
-to your \`claude_desktop_config.json\` (Settings > Developer > Edit Config):
+bi-superpowers ships two official Microsoft MCP servers. To wire them
+into Claude Desktop, add the following to your \`claude_desktop_config.json\`
+(Settings → Developer → Edit Config):
 
 \`\`\`json
 {
   "mcpServers": {
-    "powerbi-remote": {
-      "command": "npx",
-      "args": ["-y", "@anthropic-ai/mcp-remote", "https://mcp.powerbi.com/sse"]
+    "powerbi-modeling": {
+      "command": "node",
+      "args": ["<absolute path to powerbi-modeling-launcher.js>"]
     },
-    "fabric-mcp-server": {
-      "command": "npx",
-      "args": ["-y", "@anthropic-ai/mcp-remote", "https://mcp.fabric.microsoft.com/v1/sse"]
+    "microsoft-learn": {
+      "type": "http",
+      "url": "https://learn.microsoft.com/api/mcp"
     }
   }
 }
 \`\`\`
 
-After saving, restart Claude Desktop. The MCP servers will appear in your tools.
+The \`powerbi-modeling\` server requires Power BI Desktop on Windows
+with a model open. If you prefer automated setup, run
+\`super install\` from the bi-superpowers CLI — it configures both
+servers across all 5 supported AI agents.
+
+After saving, restart Claude Desktop. The MCP servers will appear in
+your tools.
 `,
         },
       },
@@ -90,6 +99,6 @@ After saving, restart Claude Desktop. The MCP servers will appear in your tools.
   })
 );
 
-// Start the server with stdio transport
+// Start the server with stdio transport.
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@luquimbo/bi-superpowers",
-  "version": "3.1.0",
-  "description": "Plugin-first Claude Code toolkit for Power BI, Microsoft Fabric, and Excel workflows powered by official Microsoft MCP servers.",
+  "version": "3.2.0",
+  "description": "Open-source Power BI Desktop toolkit for Claude Code, GitHub Copilot, Codex, Gemini CLI, and Kilo Code. Ships 2 skills and 2 official Microsoft MCP servers.",
   "main": "bin/cli.js",
   "bin": {
     "bi-superpowers": "bin/cli.js"
@@ -25,11 +25,7 @@
     "chalk": "^4.1.2",
     "chokidar": "^3.6.0",
     "cli-table3": "^0.6.5",
-    "fuse.js": "^7.3.0",
-    "gray-matter": "^4.0.3",
-    "js-yaml": "^4.1.0",
-    "ora": "^5.4.1",
-    "simple-git": "^3.22.0"
+    "ora": "^5.4.1"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
@@ -81,9 +77,7 @@
     "commands/",
     "skills/",
     "src/content/",
-    "library/",
     "desktop-extension/",
-    "docs/",
     "config.json",
     "config.example.json",
     "README.md",

package/skills/pbi-connect/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "pbi-connect"
 description: "Use when the user asks about Power BI MCP Connection Skill, especially phrases like \"connect Power BI\", \"modeling mcp\", \"Power BI Desktop\", \"conectar Power BI\", \"can't connect to Power BI\"."
-version: "3.1.0"
+version: "3.2.0"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/pbi-connect.md instead. -->

package/skills/project-kickoff/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "project-kickoff"
 description: "Project Kickoff Skill: Project analysis and planning."
-version: "3.1.0"
+version: "3.2.0"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/project-kickoff.md instead. -->

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;