@luquimbo/bi-superpowers 4.1.6 → 5.0.1

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

@@ -20,12 +20,21 @@ const {
 } = require('../microsoft-mcp');
 const { parseSkillMetadata, getSkillPurpose } = require('./shared');
 
-// Currently the plugin ships 4 skills (bi-start, project-kickoff,
-// pbi-connect, report-design). bi-start is the session-opener that
-// routes to the other three; the rest are specialists.
+// Currently the plugin ships 6 command skills:
+// - bi-start: session-opener that routes to the BI specialists.
+// - bi-kickoff: new-project bootstrap with AGENTS.md scaffolding.
+// - bi-modeling / bi-dax / bi-performance: model design, DAX, profiling.
+// - bi-connect: MCP connection + DAX UDFs.
 // The old reference-skills split is kept as an empty set so that any
 // downstream code that checks `REFERENCE_SKILLS.has(x)` still works.
-const COMMAND_SKILLS = new Set(['bi-start', 'project-kickoff', 'pbi-connect', 'report-design']);
+const COMMAND_SKILLS = new Set([
+  'bi-start',
+  'bi-kickoff',
+  'bi-modeling',
+  'bi-dax',
+  'bi-performance',
+  'bi-connect',
+]);
 
 const REFERENCE_SKILLS = new Set();
 
@@ -124,6 +133,19 @@ function toFrontmatterValue(value) {
   return JSON.stringify(value);
 }
 
+/**
+ * Return the canonical source path that maintainers should edit.
+ *
+ * @param {Object} skill - Skill definition object
+ * @returns {string} Source path relative to the repository root
+ */
+function getSourceEditPath(skill) {
+  if (skill.bundleDir) {
+    return `src/content/skills/${skill.name}/SKILL.md`;
+  }
+  return `src/content/skills/${skill.name}.md`;
+}
+
 // ---------------------------------------------------------------------------
 // Update-check preamble
 // ---------------------------------------------------------------------------
@@ -150,7 +172,7 @@ node "{skillBundleDir}/scripts/update-check.js" --silent-if-uptodate --silent-if
 
 - Empty output or \`UPTODATE\` — proceed with the skill silently. No message.
 - \`UPDATE_AVAILABLE <installed> <latest>\` — tell the user exactly once this conversation, before diving into the skill:
-  > "Hay **bi-superpowers v{latest}** disponible (estás en v{installed}). Actualizá con \`super upgrade\` (o \`/plugin update bi-superpowers\` en Claude Code) cuando te venga bien. Si estás usando un plugin local generado con \`super kickoff\`, después corré \`super recharge\` en ese repo."
+  > "bi-superpowers v{latest} is available (you are on v{installed}). Update with \`super upgrade\` (or \`/plugin update bi-superpowers\` in Claude Code) when convenient. If you use a local plugin generated with \`super kickoff\`, run \`super recharge\` in that repo afterwards."
 
   Then continue with the skill below.
 - \`SNOOZED <iso>\` — proceed silently.
@@ -185,12 +207,13 @@ function buildCommandMarkdown(skill, libraryPrefix, options = {}) {
   const description = getSkillPurpose(skill.name);
   const content = rewriteLibraryReferences(skill.content, libraryPrefix);
   const preamble = shouldIncludeUpdateCheckPreamble(skill, options) ? UPDATE_CHECK_PREAMBLE : '';
+  const sourceEditPath = getSourceEditPath(skill);
 
   return `---
 description: ${toFrontmatterValue(description)}
 ---
 
-<!-- Generated by BI Agent Superpowers. Edit src/content/skills/${skill.name}.md instead. -->
+<!-- Generated by BI Agent Superpowers. Edit ${sourceEditPath} instead. -->
 
 ${preamble}${content}`;
 }
@@ -208,6 +231,7 @@ ${preamble}${content}`;
 function buildSkillMarkdown(skill, version, libraryPrefix, options = {}) {
   const content = rewriteLibraryReferences(skill.content, libraryPrefix);
   const preamble = shouldIncludeUpdateCheckPreamble(skill, options) ? UPDATE_CHECK_PREAMBLE : '';
+  const sourceEditPath = getSourceEditPath(skill);
 
   return `---
 name: ${toFrontmatterValue(skill.name)}
@@ -215,7 +239,7 @@ description: ${toFrontmatterValue(getPluginDescription(skill))}
 version: ${toFrontmatterValue(version)}
 ---
 
-<!-- Generated by BI Agent Superpowers. Edit src/content/skills/${skill.name}.md instead. -->
+<!-- Generated by BI Agent Superpowers. Edit ${sourceEditPath} instead. -->
 
 ${preamble}${content}`;
 }

package/bin/lib/generators/shared.js

@@ -35,8 +35,8 @@ function parseSkillMetadata(content) {
   //   - Prose bullets:         - User mentions: "analizar proyecto", "new project"
   //   - Asterisk bullets:      * "pattern"
   // The regex intentionally doesn't anchor to bullet syntax — that's
-  // what broke extraction for project-kickoff (prose) and under-counted
-  // pbi-connect (first quote per bullet only) before this change.
+  // what broke extraction for bi-kickoff (prose) and under-counted
+  // bi-connect (first quote per bullet only) before this change.
   const triggerSection = content.match(/##\s+Trigger[\s\S]*?(?=##|$)/i);
   if (triggerSection) {
     const quotedFragments = triggerSection[0].match(/"([^"]+)"/g);
@@ -65,9 +65,15 @@ function parseSkillMetadata(content) {
  */
 const SKILL_PURPOSES = {
   'bi-start': 'Session opener — environment snapshot, update check, and routing to other skills',
-  'project-kickoff': 'Project analysis and planning',
-  'pbi-connect': 'Power BI Desktop connection',
-  'report-design': '3-page PBIR report generation for Power BI Desktop (Windows)',
+  'bi-kickoff':
+    'New-project bootstrap — AGENTS.md, ROADMAP.md, foundation model with fictitious data',
+  'bi-modeling':
+    'Semantic model design and audit — star schema, relationships, Date Table, health checklist',
+  'bi-dax':
+    'DAX authoring, debugging, and optimization — measures, calculation groups, SE/FE timing, Sallieri patterns',
+  'bi-performance':
+    'Performance profiling — Performance Analyzer, VertiPaq DMVs, refresh diagnostics, Tabular Editor 2 / BPA',
+  'bi-connect': 'Power BI Desktop MCP connection and DAX UDF authoring',
 };
 
 /**
@@ -205,8 +211,6 @@ function getFormatFooter() {
 ## Resources
 
 - Skills: \`skills/*/SKILL.md\` - BI workflow instructions
-- Report design references: \`skills/report-design/references/\` - PBIR layouts, themes, native visuals, and troubleshooting
-- Runtime scripts: \`skills/report-design/scripts/\` - PBIR visual, theme, and validation helpers
 
 ---
 

package/bin/lib/mcp-config.js

@@ -31,6 +31,19 @@ const os = require('os');
 const MICROSOFT_LEARN_URL = 'https://learn.microsoft.com/api/mcp';
 const MODELING_SERVER_NAME = 'powerbi-modeling-mcp';
 const LEARN_SERVER_NAME = 'microsoft-learn';
+const CODEX_POWERBI_WRITE_TOOLS = [
+  'column_operations',
+  'database_operations',
+  'function_operations',
+  'measure_operations',
+  'object_translation_operations',
+  'partition_operations',
+  'perspective_operations',
+  'query_group_operations',
+  'relationship_operations',
+  'table_operations',
+  'user_hierarchy_operations',
+];
 
 /**
  * Resolves the absolute path to the Power BI Modeling MCP launcher
@@ -418,18 +431,25 @@ function writeCodexConfig(packageDir) {
   // Remove any previous bi-superpowers MCP sections so re-running install
   // doesn't duplicate them. Strips each section from its header to the
   // next [ header or EOF. Server names are escaped for regex safety even
-  // though current values are literal — defensive against future renames.
+  // though current values are literal. The optional suffix removes child
+  // sections like [mcp_servers.powerbi-modeling-mcp.tools.measure_operations].
   const namePattern = [MODELING_SERVER_NAME, LEARN_SERVER_NAME].map(escapeRegex).join('|');
   const stripPattern = new RegExp(
-    `\\n?\\[mcp_servers\\.(${namePattern})\\][\\s\\S]*?(?=\\n\\[|$)`,
+    `\\n?\\[mcp_servers\\.(${namePattern})(?:\\.[^\\]]+)?\\][\\s\\S]*?(?=\\n\\[|$)`,
     'g'
   );
   existing = existing.replace(stripPattern, '');
 
+  const writeToolApprovals = CODEX_POWERBI_WRITE_TOOLS.map(
+    (toolName) =>
+      `\n[mcp_servers.${MODELING_SERVER_NAME}.tools.${toolName}]\n` + 'approval_mode = "approve"\n'
+  ).join('');
+
   const newSections =
     `\n\n[mcp_servers.${MODELING_SERVER_NAME}]\n` +
     'command = "node"\n' +
     `args = ["${tomlEscape(launcher)}"]\n` +
+    writeToolApprovals +
     `\n[mcp_servers.${LEARN_SERVER_NAME}]\n` +
     `url = "${MICROSOFT_LEARN_URL}"\n`;
 

package/bin/lib/skills.js

@@ -38,7 +38,7 @@ function loadFlatSkill(filePath) {
       bundleDir: null,
     };
   } catch (err) {
-    console.warn(`⚠ No pude leer el skill ${filePath}: ${err.message}`);
+    console.warn(`⚠ Could not read skill ${filePath}: ${err.message}`);
     return null;
   }
 }
@@ -63,7 +63,7 @@ function loadFolderSkill(folderPath) {
       bundleDir: folderPath,
     };
   } catch (err) {
-    console.warn(`⚠ No pude leer el skill ${skillMd}: ${err.message}`);
+    console.warn(`⚠ Could not read skill ${skillMd}: ${err.message}`);
     return null;
   }
 }
@@ -89,7 +89,7 @@ function readSkillDirectory(directory) {
   try {
     entries = fs.readdirSync(directory, { withFileTypes: true });
   } catch (err) {
-    console.warn(`⚠ No pude leer el directorio de skills ${directory}: ${err.message}`);
+    console.warn(`⚠ Could not read skills directory ${directory}: ${err.message}`);
     return [];
   }
 
@@ -138,16 +138,16 @@ function loadSkills(options = {}) {
 /**
  * Normalize any user-facing skill identifier into its canonical name.
  *
- * Accepts `dax`, `dax.md`, `report-design`, `report-design/SKILL.md`,
- * or `report-design\SKILL.md` (Windows separator) and returns the
+ * Accepts `dax`, `dax.md`, `folder-skill`, `folder-skill/SKILL.md`,
+ * or `folder-skill\SKILL.md` (Windows separator) and returns the
  * canonical skill name used as the key in readSkillDirectory's
- * output map (`dax`, `report-design`).
+ * output map (`dax`, `folder-skill`).
  *
  * Uses a single alternation regex so the longer suffix `/SKILL.md`
  * is tried BEFORE the bare `.md`. Earlier callers chained two
  * `.replace()` calls and stripped `.md` first, which meant the
- * `/SKILL.md` alternative never matched — `report-design/SKILL.md`
- * came out as `report-design/SKILL` and the lookup failed.
+ * `/SKILL.md` alternative never matched — `folder-skill/SKILL.md`
+ * came out as `folder-skill/SKILL` and the lookup failed.
  *
  * @param {string} input - User-supplied skill identifier
  * @returns {string} Canonical skill name

package/bin/mcp/powerbi-modeling-launcher.js

@@ -18,10 +18,14 @@ if (!executablePath) {
   process.exit(1);
 }
 
-const child = spawn(executablePath, ['--start', ...process.argv.slice(2)], {
-  stdio: 'inherit',
-  env: process.env,
-});
+const child = spawn(
+  executablePath,
+  ['--readwrite', '--skip-confirmation', ...process.argv.slice(2)],
+  {
+    stdio: 'inherit',
+    env: process.env,
+  }
+);
 
 child.on('error', (error) => {
   console.error(`Failed to launch Power BI Modeling MCP: ${error.message}`);

package/bin/postinstall.js

@@ -2,7 +2,7 @@
 
 /**
  * Post-install script for BI Agent Superpowers
- * Shows helpful information after npm install
+ * Shows helpful information after npm install.
  * Developed by Lucas Sanchez (@luquimbo)
  */
 
@@ -12,32 +12,34 @@ console.log(`
 ╔═══════════════════════════════════════════════════════════╗
 ║                                                           ║
 ║   BI Agent Superpowers v${VERSION.padEnd(34)}║
-║   Plugin para Power BI Desktop — open source (MIT)        ║
+║   Power BI Desktop toolkit — open source (MIT)            ║
 ║   Developed by Lucas Sanchez (@luquimbo)                 ║
 ║                                                           ║
 ╚═══════════════════════════════════════════════════════════╝
 
-Instalado correctamente.
+Installed successfully.
 
 Quick Start:
-  super install              # Instalá skills + MCPs en tus agentes AI
+  super install              # Install skills + MCPs in your AI agents
 
-Funciona con los 5 agentes:
+Works with 5 agents:
   • Claude Code
   • GitHub Copilot
   • Codex (OpenAI)
   • Gemini CLI
   • Kilo Code
 
-4 skills iniciales:
-  /bi-start          — Arrancar una sesión (menú + update + conexión)
-  /project-kickoff   — Analizá tu proyecto BI (proyecto nuevo)
-  /pbi-connect       — Conectá tu agente a Power BI Desktop
-  /report-design     — Generá reportes PBIR para Power BI Desktop (Windows)
+6 skills:
+  /bi-start          — Session opener and specialist routing
+  /bi-kickoff        — New BI project bootstrap
+  /bi-modeling       — Semantic model design and audit
+  /bi-dax            — DAX authoring, debugging, and optimization
+  /bi-performance    — Performance profiling, VertiPaq, and BPA
+  /bi-connect        — Power BI Desktop MCP connection and DAX UDFs
 
 2 MCP servers:
-  powerbi-modeling-mcp — Conexión local a Power BI Desktop (XMLA)
-  microsoft-learn    — Docs de Microsoft Learn en contexto
+  powerbi-modeling-mcp — Local Power BI Desktop connection (XMLA)
+  microsoft-learn      — Microsoft Learn docs in context
 
 Documentation: https://github.com/luquimbo/bi-superpowers
 `);

package/bin/utils/mcp-detect.js

@@ -179,33 +179,33 @@ function getMcpStatus() {
  */
 function getInstallInstructions() {
   return {
-    title: 'Power BI Modeling MCP no detectado',
+    title: 'Power BI Modeling MCP not detected',
     options: [
       {
         name: 'VS Code / Cursor',
         steps: [
-          'Abrir VS Code o Cursor',
-          'Ir a Extensions (Ctrl+Shift+X)',
-          'Buscar "Power BI Modeling MCP"',
-          'Instalar la extensión de Microsoft',
-          'Ejecutar: super install --all --yes',
+          'Open VS Code or Cursor',
+          'Go to Extensions (Ctrl+Shift+X)',
+          'Search for "Power BI Modeling MCP"',
+          'Install the Microsoft extension',
+          'Run: super install --all --yes',
         ],
         link: 'https://aka.ms/powerbi-modeling-mcp-vscode',
       },
       {
         name: 'Manual',
         steps: [
-          'Descargar VSIX desde VS Code Marketplace',
-          'Renombrar .vsix a .zip',
-          `Extraer a ${path.join(os.homedir(), '.bi-superpowers', 'mcp')}`,
-          'Configurar BI_SUPERPOWERS_POWERBI_MODELING_MCP_PATH con la ruta al .exe',
+          'Download the VSIX from VS Code Marketplace',
+          'Rename .vsix to .zip',
+          `Extract to ${path.join(os.homedir(), '.bi-superpowers', 'mcp')}`,
+          'Set BI_SUPERPOWERS_POWERBI_MODELING_MCP_PATH to the .exe path',
         ],
         link: 'https://marketplace.visualstudio.com/items?itemName=analysis-services.powerbi-modeling-mcp',
       },
     ],
     note:
       os.platform() !== 'win32'
-        ? 'El MCP local solo está disponible en Windows. En Mac/Linux tenés microsoft-learn para docs oficiales.'
+        ? 'The local MCP is only available on Windows. On macOS/Linux, microsoft-learn still provides official docs.'
         : null,
   };
 }