@luquimbo/bi-superpowers 3.0.1 → 3.1.0

package/.claude-plugin/marketplace.json

@@ -5,14 +5,14 @@
     "url": "https://github.com/luquimbo"
   },
   "metadata": {
-    "description": "AI-powered skills for Power BI, Microsoft Fabric, and Excel development. 24 skills covering DAX, Power Query, data modeling, report design, governance, and more.",
-    "version": "3.0.1",
+    "description": "AI-powered skills for Power BI Desktop development. Works with Claude Code, GitHub Copilot, Codex, Gemini CLI, and Kilo Code.",
+    "version": "3.1.0",
     "repository": "https://github.com/luquimbo/bi-superpowers"
   },
   "plugins": [
     {
       "name": "bi-superpowers",
-      "description": "24 AI skills for Power BI, Fabric & Excel — DAX, Power Query, data modeling, star schema design, report design, governance, deployment, and more.",
+      "description": "2 AI skills + Power BI Modeling and Microsoft Learn MCP servers for local Power BI Desktop workflows across 5 AI agents.",
       "source": "./",
       "strict": false,
       "skills": [

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "bi-superpowers",
   "description": "Claude Code plugin for Power BI, Microsoft Fabric, and semantic model workflows powered by the official Microsoft MCP servers.",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "author": {
     "name": "Lucas Sanchez"
   }

package/.claude-plugin/skill-manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "bi-superpowers",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "skillCount": 2,
   "skills": [
     {

package/.plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "spec": "open-plugin-spec@1",
   "name": "bi-superpowers",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "description": "Claude Code plugin for Power BI, Microsoft Fabric, and semantic model workflows powered by the official Microsoft MCP servers.",
   "author": {
     "name": "Lucas Sanchez"

package/README.md

@@ -89,6 +89,25 @@ super install --all --yes
 
 ---
 
+## Alternativas para instalar los MCPs
+
+`super install` escribe automáticamente los 2 MCPs en el config file de cada agente. Pero hay otras formas de instalar los mismos MCPs — cualquiera de estas funciona igual de bien:
+
+### Para Power BI Modeling MCP (local)
+
+- **Extensión de VS Code** — Microsoft publica "Power BI Modeling MCP" en el VS Code Marketplace. Si la instalás, VS Code + Copilot lo descubren automáticamente sin tocar archivos de config.
+- **Extensión de Cursor** — misma extensión, Cursor la detecta.
+- **Manual** — descargá el binario `.exe` y configurá `BI_SUPERPOWERS_POWERBI_MODELING_MCP_PATH` apuntando al ejecutable.
+
+### Para Microsoft Learn MCP (HTTP)
+
+- **MCP marketplace oficial de Anthropic** — en Claude Code se puede hacer `/plugin marketplace add anthropic/mcp-registry` y después `/plugin install microsoft-learn` (según disponibilidad).
+- **Agregarlo a mano** en el config file del agente con la URL `https://learn.microsoft.com/api/mcp`.
+
+Si ya instalaste los MCPs por alguno de estos caminos, no necesitás correr `super install` — o, si lo corrés, los configs se mergean sin conflicto (cada agente tiene merge por clave, no por overwrite).
+
+---
+
 ## Requisitos
 
 - **Node.js ≥ 18**

package/bin/commands/install.js

@@ -276,6 +276,44 @@ function performInstall(skillsSourceDir, skillDirs, selectedAgents, baseDir) {
   return { agentResults, copyFallbacks };
 }
 
+/**
+ * Configura los 2 MCP servers (powerbi-modeling + microsoft-learn)
+ * para cada agente seleccionado escribiendo el config file en el path
+ * y formato que cada agente espera.
+ *
+ * Los errores por agente no interrumpen el flujo: se recolectan en los
+ * resultados para mostrarlos al final y que el caller decida qué hacer
+ * con el exit code.
+ *
+ * @param {string[]} selectedAgents - IDs de agentes seleccionados
+ * @param {string} packageDir - Absolute path al paquete instalado
+ * @param {string} baseDir - Home directory del usuario (para display)
+ * @param {Object} chalk - chalk instance para colorear output
+ * @returns {Array<{agent: string, success: boolean, configPath?: string, error?: string}>}
+ */
+function configureMcpsForAgents(selectedAgents, packageDir, baseDir, chalk) {
+  console.log(
+    chalk.cyan('\n  Configurando MCP servers (Power BI Modeling + Microsoft Learn)...\n')
+  );
+
+  const results = [];
+  for (const agentId of selectedAgents) {
+    const agent = AGENTS[agentId];
+    try {
+      const configPath = writeMcpConfigForAgent(agentId, packageDir);
+      if (configPath) {
+        const relPath = configPath.replace(baseDir, '~');
+        console.log(chalk.green(`  ✓ ${relPath} — ${agent.name}`));
+        results.push({ agent: agent.name, configPath, success: true });
+      }
+    } catch (err) {
+      console.log(chalk.red(`  ✗ ${agent.name}: ${err.message}`));
+      results.push({ agent: agent.name, success: false, error: err.message });
+    }
+  }
+  return results;
+}
+
 /**
  * Handler principal del comando install.
  * @param {string[]} args - Argumentos CLI
@@ -386,24 +424,7 @@ async function installCommand(args, config) {
   }
 
   // Configurar MCPs para cada agente seleccionado
-  console.log(
-    chalk.cyan('\n  Configurando MCP servers (Power BI Modeling + Microsoft Learn)...\n')
-  );
-  const mcpResults = [];
-  for (const agentId of selectedAgents) {
-    const agent = AGENTS[agentId];
-    try {
-      const configPath = writeMcpConfigForAgent(agentId, packageDir);
-      if (configPath) {
-        const relPath = configPath.replace(baseDir, '~');
-        console.log(chalk.green(`  ✓ ${relPath} — ${agent.name}`));
-        mcpResults.push({ agent: agent.name, configPath, success: true });
-      }
-    } catch (err) {
-      console.log(chalk.red(`  ✗ ${agent.name}: ${err.message}`));
-      mcpResults.push({ agent: agent.name, success: false, error: err.message });
-    }
-  }
+  const mcpResults = configureMcpsForAgents(selectedAgents, packageDir, baseDir, chalk);
 
   // Resumen
   const totalAgents = agentResults.length + (universalAgents.length > 0 ? 1 : 0);

package/bin/lib/generators/claude-plugin.js

@@ -193,7 +193,14 @@ async function generate(targetDir, skills, options = {}) {
     JSON.stringify(pluginManifest, null, 2) + '\n'
   );
 
-  // Generate marketplace.json with all skills listed and synced version
+  // Generate marketplace.json with all skills listed and synced version.
+  // The descriptions are derived from the actual skill count so they never
+  // drift out of sync with the real plugin contents.
+  const skillCount = skills.length;
+  const skillsPlural = skillCount === 1 ? 'skill' : 'skills';
+  const metadataDescription = `AI-powered ${skillsPlural} for Power BI Desktop development. Works with Claude Code, GitHub Copilot, Codex, Gemini CLI, and Kilo Code.`;
+  const pluginDescription = `${skillCount} AI ${skillsPlural} + Power BI Modeling and Microsoft Learn MCP servers for local Power BI Desktop workflows across 5 AI agents.`;
+
   const marketplaceManifest = {
     name: 'bi-superpowers',
     owner: {
@@ -201,16 +208,14 @@ async function generate(targetDir, skills, options = {}) {
       url: 'https://github.com/luquimbo',
     },
     metadata: {
-      description:
-        'AI-powered skills for Power BI, Microsoft Fabric, and Excel development. 24 skills covering DAX, Power Query, data modeling, report design, governance, and more.',
+      description: metadataDescription,
       version,
       repository: 'https://github.com/luquimbo/bi-superpowers',
     },
     plugins: [
       {
         name: 'bi-superpowers',
-        description:
-          '24 AI skills for Power BI, Fabric & Excel — DAX, Power Query, data modeling, star schema design, report design, governance, deployment, and more.',
+        description: pluginDescription,
         source: './',
         strict: false,
         skills: skills.map((skill) => `./skills/${skill.name}`).sort(),

package/bin/lib/mcp-config.js

@@ -111,50 +111,113 @@ function escapeRegex(str) {
 }
 
 // ============================================
-// CLAUDE CODE
+// JSON AGENT CONFIGURATIONS
 // ============================================
-// Writes ~/.claude.json, adding to `mcpServers`. Preserves other user-level
-// config in that file (projects, settings, etc.).
-function writeClaudeCodeConfig(packageDir) {
-  const configPath = path.join(os.homedir(), '.claude.json');
-  const existing = readJsonSafe(configPath) || {};
-  const mcpServers = { ...(existing.mcpServers || {}) };
+// The 4 JSON-based agents (Claude Code, GitHub Copilot, Gemini CLI,
+// Kilo Code) all follow the same pattern: read existing JSON, merge
+// our 2 servers into a wrapper key, write back. Each agent differs
+// only in:
+//  - The config file path
+//  - The wrapper key (`mcpServers` vs `servers`)
+//  - Whether the stdio entry needs an explicit `type` field
+//  - The HTTP URL field name (`url` vs `httpUrl`)
+//
+// We describe each agent in a single table and build the writer functions
+// from it so adding a new JSON agent is a one-line change.
 
-  mcpServers[MODELING_SERVER_NAME] = {
+const JSON_AGENT_CONFIGS = {
+  'claude-code': {
+    // Claude Code user-scope MCP config lives in ~/.claude.json under
+    // mcpServers. stdio entries omit `type`, HTTP entries include it.
+    configPath: () => path.join(os.homedir(), '.claude.json'),
+    wrapperKey: 'mcpServers',
+    stdioIncludesType: false,
+    httpIncludesType: true,
+    httpField: 'url',
+  },
+  'github-copilot': {
+    // Copilot CLI uses `servers` (NOT mcpServers) and every server needs
+    // an explicit `type` field.
+    configPath: () => path.join(os.homedir(), '.copilot', 'mcp-config.json'),
+    wrapperKey: 'servers',
+    stdioIncludesType: true,
+    httpIncludesType: true,
+    httpField: 'url',
+  },
+  'gemini-cli': {
+    // Gemini uses `httpUrl` (NOT `url`) for HTTP transports and omits
+    // `type` — it's inferred from which key is present.
+    configPath: () => path.join(os.homedir(), '.gemini', 'settings.json'),
+    wrapperKey: 'mcpServers',
+    stdioIncludesType: false,
+    httpIncludesType: false,
+    httpField: 'httpUrl',
+  },
+  kilo: {
+    // Kilo uses the canonical `mcpServers` with `url` for HTTP.
+    configPath: () => path.join(os.homedir(), '.kilocode', 'mcp_settings.json'),
+    wrapperKey: 'mcpServers',
+    stdioIncludesType: false,
+    httpIncludesType: false,
+    httpField: 'url',
+  },
+};
+
+/**
+ * Build the two-server JSON payload for a JSON-format agent.
+ * Each agent differs in whether it wants `type` fields and which key
+ * holds the HTTP URL (`url` vs `httpUrl`).
+ *
+ * @param {Object} agentConfig - Descriptor from JSON_AGENT_CONFIGS
+ * @param {string} packageDir - Absolute path to the installed package
+ * @returns {Object} Map of server name → server config
+ */
+function buildJsonServers(agentConfig, packageDir) {
+  // Modeling (stdio local launcher)
+  const modelingEntry = {
     command: 'node',
     args: [getLauncherAbsolutePath(packageDir)],
   };
-  mcpServers[LEARN_SERVER_NAME] = {
-    type: 'http',
-    url: MICROSOFT_LEARN_URL,
-  };
+  if (agentConfig.stdioIncludesType) {
+    // Put type first for readability
+    const { command, args } = modelingEntry;
+    Object.keys(modelingEntry).forEach((k) => delete modelingEntry[k]);
+    modelingEntry.type = 'stdio';
+    modelingEntry.command = command;
+    modelingEntry.args = args;
+  }
 
-  writeJson(configPath, { ...existing, mcpServers });
-  return configPath;
+  // Microsoft Learn (HTTP)
+  const learnEntry = {};
+  if (agentConfig.httpIncludesType) {
+    learnEntry.type = 'http';
+  }
+  learnEntry[agentConfig.httpField] = MICROSOFT_LEARN_URL;
+
+  return {
+    [MODELING_SERVER_NAME]: modelingEntry,
+    [LEARN_SERVER_NAME]: learnEntry,
+  };
 }
 
-// ============================================
-// GITHUB COPILOT CLI
-// ============================================
-// Writes ~/.copilot/mcp-config.json. Copilot uses `servers` (NOT mcpServers)
-// and each server has an explicit `type` field.
-function writeCopilotConfig(packageDir) {
-  const configPath = path.join(os.homedir(), '.copilot', 'mcp-config.json');
-  const existing = readJsonSafe(configPath) || {};
-  const servers = { ...(existing.servers || {}) };
+/**
+ * Create a writer function for a JSON-format agent.
+ * The returned function reads the existing config (if any), merges in
+ * our 2 servers, and writes back, preserving all other fields.
+ */
+function makeJsonWriter(agentId) {
+  const agentConfig = JSON_AGENT_CONFIGS[agentId];
+  return function jsonWriter(packageDir) {
+    const configPath = agentConfig.configPath();
+    const existing = readJsonSafe(configPath) || {};
+    const wrapperKey = agentConfig.wrapperKey;
 
-  servers[MODELING_SERVER_NAME] = {
-    type: 'stdio',
-    command: 'node',
-    args: [getLauncherAbsolutePath(packageDir)],
-  };
-  servers[LEARN_SERVER_NAME] = {
-    type: 'http',
-    url: MICROSOFT_LEARN_URL,
-  };
+    const newServers = buildJsonServers(agentConfig, packageDir);
+    const mergedServers = { ...(existing[wrapperKey] || {}), ...newServers };
 
-  writeJson(configPath, { ...existing, servers });
-  return configPath;
+    writeJson(configPath, { ...existing, [wrapperKey]: mergedServers });
+    return configPath;
+  };
 }
 
 // ============================================
@@ -201,59 +264,17 @@ function writeCodexConfig(packageDir) {
   return configPath;
 }
 
-// ============================================
-// GEMINI CLI
-// ============================================
-// Writes ~/.gemini/settings.json. Gemini uses `mcpServers` and `httpUrl`
-// (not `url`) for HTTP transports.
-function writeGeminiConfig(packageDir) {
-  const configPath = path.join(os.homedir(), '.gemini', 'settings.json');
-  const existing = readJsonSafe(configPath) || {};
-  const mcpServers = { ...(existing.mcpServers || {}) };
-
-  mcpServers[MODELING_SERVER_NAME] = {
-    command: 'node',
-    args: [getLauncherAbsolutePath(packageDir)],
-  };
-  mcpServers[LEARN_SERVER_NAME] = {
-    httpUrl: MICROSOFT_LEARN_URL,
-  };
-
-  writeJson(configPath, { ...existing, mcpServers });
-  return configPath;
-}
-
-// ============================================
-// KILO CODE
-// ============================================
-// Writes ~/.kilocode/mcp_settings.json. Kilo uses `mcpServers` and `url`
-// for HTTP transports.
-function writeKiloConfig(packageDir) {
-  const configPath = path.join(os.homedir(), '.kilocode', 'mcp_settings.json');
-  const existing = readJsonSafe(configPath) || {};
-  const mcpServers = { ...(existing.mcpServers || {}) };
-
-  mcpServers[MODELING_SERVER_NAME] = {
-    command: 'node',
-    args: [getLauncherAbsolutePath(packageDir)],
-  };
-  mcpServers[LEARN_SERVER_NAME] = {
-    url: MICROSOFT_LEARN_URL,
-  };
-
-  writeJson(configPath, { ...existing, mcpServers });
-  return configPath;
-}
-
 /**
  * Registry mapping agent IDs to their MCP config writers.
+ * JSON agents are generated from JSON_AGENT_CONFIGS via makeJsonWriter;
+ * Codex is the only TOML-based agent and has its own writer.
  */
 const MCP_WRITERS = {
-  'claude-code': writeClaudeCodeConfig,
-  'github-copilot': writeCopilotConfig,
+  'claude-code': makeJsonWriter('claude-code'),
+  'github-copilot': makeJsonWriter('github-copilot'),
   codex: writeCodexConfig,
-  'gemini-cli': writeGeminiConfig,
-  kilo: writeKiloConfig,
+  'gemini-cli': makeJsonWriter('gemini-cli'),
+  kilo: makeJsonWriter('kilo'),
 };
 
 /**

package/bin/lib/mcp-config.test.js

@@ -204,6 +204,43 @@ describe('MCP writers — JSON agents', () => {
     });
   }
 
+  // Cross-agent sanity check: verifies each JSON agent writes the HTTP
+  // URL under the correct key per its spec. Catches copy-paste errors
+  // where someone might accidentally use `url` for Gemini (which expects
+  // `httpUrl`) or vice versa.
+  test('each JSON agent uses the correct HTTP field name', () => {
+    const expectations = {
+      'claude-code': { key: 'url', wrapperKey: 'mcpServers' },
+      'github-copilot': { key: 'url', wrapperKey: 'servers' },
+      'gemini-cli': { key: 'httpUrl', wrapperKey: 'mcpServers' },
+      kilo: { key: 'url', wrapperKey: 'mcpServers' },
+    };
+
+    for (const [agentId, expected] of Object.entries(expectations)) {
+      // Reset home for each agent so configs don't leak between writes.
+      fs.rmSync(tempHome, { recursive: true, force: true });
+      fs.mkdirSync(tempHome, { recursive: true });
+
+      const configPath = MCP_WRITERS[agentId](fakePkgDir);
+      const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+      const learnEntry = config[expected.wrapperKey][LEARN_SERVER_NAME];
+
+      assert.strictEqual(
+        learnEntry[expected.key],
+        MICROSOFT_LEARN_URL,
+        `${agentId} should use "${expected.key}" for HTTP URL`
+      );
+
+      // And it should NOT use the wrong key (defensive check)
+      const wrongKey = expected.key === 'url' ? 'httpUrl' : 'url';
+      assert.strictEqual(
+        learnEntry[wrongKey],
+        undefined,
+        `${agentId} should NOT have "${wrongKey}"`
+      );
+    }
+  });
+
   test('writeJson refuses to overwrite symlinked target', () => {
     const realFile = path.join(tempHome, 'real-claude.json');
     const linkFile = path.join(tempHome, '.claude.json');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luquimbo/bi-superpowers",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "description": "Plugin-first Claude Code toolkit for Power BI, Microsoft Fabric, and Excel workflows powered by official Microsoft MCP servers.",
   "main": "bin/cli.js",
   "bin": {

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.0.1"
+version: "3.1.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.0.1"
+version: "3.1.0"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/project-kickoff.md instead. -->