@luquimbo/bi-superpowers 1.0.0 → 1.1.2

package/bin/cli.js

@@ -43,7 +43,7 @@ try {
 // Wrapped in try-catch because they may not be available during initial npm install
 let searchCommand, lintCommand, diffCommand, watchCommand, mcpSetupCommand, tui;
 let setupCommand, addCommand, pullCommand, pushCommand, syncProfileCommand, syncSourceCommand;
-let changelogCommand, buildDesktopCommand;
+let changelogCommand, buildDesktopCommand, installCommand;
 try {
   searchCommand = require('./commands/search'); // Fuzzy search across library content
   lintCommand = require('./commands/lint'); // Skill file validation
@@ -61,6 +61,7 @@ try {
   syncSourceCommand = require('./commands/sync-source'); // Bidirectional sync
   changelogCommand = require('./commands/changelog'); // Generate changelog from Git
   buildDesktopCommand = require('./commands/build-desktop'); // Build MCPB for Claude Desktop
+  installCommand = require('./commands/install'); // Multi-agent skill installer
 } catch (e) {
   // Silent fail - commands may not be available during npm install phase
   // This is expected behavior, not an error condition
@@ -126,47 +127,29 @@ const AI_TOOLS = generators ? generators.AI_TOOLS : {};
  * - Developer: Advanced tools for content management (xray, checkup, scan, sentinel, powers)
  * - Legacy: Old command names maintained for backward compatibility
  */
+// Commands are registered lazily to avoid TDZ issues with const wrappers.
+// Core commands use hoisted function declarations; developer commands use
+// createCommandWrapper which is defined later. We populate the map in
+// registerCommands() which runs before main().
 const commands = {
-  // Core commands - basic info and status
+  // Core commands - basic info and status (hoisted functions, safe here)
   help: showHelp,
   version: showVersion,
   about: showInfo,
   status: showLicenseStatus,
 
-  // Setup & sync - project configuration
-  kickoff: initProject, // Interactive project setup wizard
-  recharge: syncProject, // Regenerate AI tool configs from skills
-  unlock: activateLicense, // Activate license key
-  upgrade: updatePackage, // Update to latest npm version
-
-  // Developer tools - content management
-  xray: runSearch, // Fuzzy search library content
-  checkup: runLint, // Validate skill files
-  scan: runDiff, // Compare source vs generated
-  sentinel: runWatch, // Watch and auto-regenerate
-  powers: listAgents, // List available skills
-  'mcp-setup': runMcpSetup, // Configure MCP servers for AI tools
-  mcp: runMcpSetup, // Alias for mcp-setup
-  'build-desktop': runBuildDesktop, // Build MCPB extension for Claude Desktop
+  // Setup & sync - project configuration (hoisted functions, safe here)
+  kickoff: initProject,
+  recharge: syncProject,
+  unlock: activateLicense,
+  upgrade: updatePackage,
+  powers: listAgents,
 
-  // Repo multi-project commands (v3)
-  setup: runSetup, // Onboarding wizard - creates bi-repo
-  add: runAdd, // Add project to bi-repo
-  pull: runPull, // Pull changes from original file to repo
-  push: runPush, // Push changes from repo to original file
-  'sync-source': runSyncSource, // Bidirectional sync with original file
-  'sync-profile': runSyncProfile, // Sync snippets to base profile
-  changelog: runChangelog, // Generate changelog from Git history
-
-  // Legacy aliases (backward compatibility with v2.0.x)
+  // Legacy aliases (hoisted functions, safe here)
   init: initProject,
   sync: syncProject,
   activate: activateLicense,
   update: updatePackage,
-  search: runSearch,
-  lint: runLint,
-  diff: runDiff,
-  watch: runWatch,
   list: listAgents,
   info: showInfo,
 };
@@ -199,6 +182,7 @@ Usage:
   super <command> [options]
 
 Commands:
+  install           Install skills for your AI agents (Claude, Copilot, Codex...)
   unlock            Activate your license key
   kickoff [path]    Initialize the Claude Code plugin in your project
   recharge [path]   Regenerate the plugin from source skills
@@ -225,7 +209,15 @@ Repo Multi-Proyecto (v3):
 Options:
   --dry-run       Preview changes without creating files (kickoff, recharge)
 
+Install options:
+  --agent, -a     Specify agents (e.g. -a claude-code -a codex)
+  --all           Install for all supported agents
+  --yes, -y       Skip confirmation prompts
+
 Examples:
+  super install                  # Interactive multi-agent installer
+  super install -a claude-code   # Install for Claude Code only
+  super install --all --yes      # Install for all agents, no prompts
   super unlock                   # Activate your license
   super kickoff                  # Initialize plugin in current directory
   super kickoff ./my-project     # Initialize in specific directory
@@ -1006,6 +998,28 @@ const runSyncSource = createCommandWrapper(syncSourceCommand, 'Sync-source');
 const runSyncProfile = createCommandWrapper(syncProfileCommand, 'Sync-profile');
 const runChangelog = createCommandWrapper(changelogCommand, 'Changelog');
 const runBuildDesktop = createCommandWrapper(buildDesktopCommand, 'Build Desktop');
+const runInstall = createCommandWrapper(installCommand, 'Install');
+
+// Register commands that depend on createCommandWrapper (avoids TDZ in object literal)
+commands.install = runInstall;
+commands.xray = runSearch;
+commands.checkup = runLint;
+commands.scan = runDiff;
+commands.sentinel = runWatch;
+commands['mcp-setup'] = runMcpSetup;
+commands.mcp = runMcpSetup;
+commands['build-desktop'] = runBuildDesktop;
+commands.setup = runSetup;
+commands.add = runAdd;
+commands.pull = runPull;
+commands.push = runPush;
+commands['sync-source'] = runSyncSource;
+commands['sync-profile'] = runSyncProfile;
+commands.changelog = runChangelog;
+commands.search = runSearch;
+commands.lint = runLint;
+commands.diff = runDiff;
+commands.watch = runWatch;
 
 /**
  * Run watch command (special case - needs additional context)

package/bin/commands/install.js

@@ -0,0 +1,317 @@
+/**
+ * Install Command - Multi-agent skill installer
+ * ===============================================
+ *
+ * Installs BI Agent Superpowers skills into the correct directories
+ * for each AI coding agent. Inspired by the `npx skills` CLI from Vercel Labs.
+ *
+ * Skills are always installed at the user level (~/) to protect licensed content.
+ *
+ * Usage:
+ *   npx @luquimbo/bi-superpowers install
+ *   super install
+ *   super install --agent claude-code --agent codex
+ *   super install --all --yes
+ *
+ * @module commands/install
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const readline = require('readline');
+
+// Agent registry: each agent's skill directory path (relative to home directory)
+// Order matches the interactive installer display order
+const AGENTS = {
+  'github-copilot': { name: 'GitHub Copilot', dir: '.github/skills' },
+  'claude-code': { name: 'Claude Code', dir: '.claude/skills' },
+  codex: { name: 'Codex (OpenAI)', dir: '.agents/skills' },
+  'gemini-cli': { name: 'Gemini CLI', dir: '.gemini/skills' },
+  kilo: { name: 'Kilo Code', dir: '.kilocode/skills' },
+};
+
+// Universal path — most agents read from .agents/skills/
+const UNIVERSAL_DIR = '.agents/skills';
+
+/**
+ * Detect which agents are available by checking for their config directories
+ * @param {string} baseDir - Directory to check (project root or home)
+ * @returns {string[]} Array of detected agent IDs
+ */
+function detectAgents(baseDir) {
+  const detected = [];
+  for (const [id, agent] of Object.entries(AGENTS)) {
+    const agentRoot = path.dirname(agent.dir);
+    const checkPath = path.join(baseDir, agentRoot);
+    if (fs.existsSync(checkPath)) {
+      detected.push(id);
+    }
+  }
+  return detected;
+}
+
+/**
+ * Create readline interface for interactive prompts
+ */
+function createReadline() {
+  return readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+}
+
+/**
+ * Prompt user with a question
+ */
+function prompt(rl, question) {
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => resolve(answer.trim()));
+  });
+}
+
+/**
+ * Display a numbered list and let user pick multiple items
+ * @param {readline.Interface} rl
+ * @param {Array<{id: string, name: string}>} items
+ * @param {string[]} preselected - IDs to preselect
+ * @returns {Promise<string[]>} Selected IDs
+ */
+async function selectMultiple(rl, items, preselected = []) {
+  items.forEach((item, i) => {
+    const marker = preselected.includes(item.id) ? '●' : '○';
+    console.log(`  ${i + 1}) ${marker} ${item.name}`);
+  });
+  console.log();
+  console.log('  Enter numbers separated by commas (e.g. 1,2,3)');
+  console.log('  Press Enter for detected agents, or "a" for all');
+
+  const answer = await prompt(rl, '\n  > ');
+
+  if (answer.toLowerCase() === 'a') {
+    return items.map((item) => item.id);
+  }
+
+  if (answer === '') {
+    return preselected.length > 0 ? preselected : items.map((item) => item.id);
+  }
+
+  const indices = answer
+    .split(',')
+    .map((s) => parseInt(s.trim(), 10) - 1)
+    .filter((i) => i >= 0 && i < items.length);
+
+  return indices.map((i) => items[i].id);
+}
+
+/**
+ * Copy a skill directory to a target location
+ * @param {string} srcDir - Source skill directory (containing SKILL.md)
+ * @param {string} destDir - Destination directory
+ */
+function copySkillDir(srcDir, destDir) {
+  if (!fs.existsSync(destDir)) {
+    fs.mkdirSync(destDir, { recursive: true });
+  }
+
+  const entries = fs.readdirSync(srcDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(srcDir, entry.name);
+    const destPath = path.join(destDir, entry.name);
+
+    if (entry.isDirectory()) {
+      copySkillDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+/**
+ * Main install command handler
+ * @param {string[]} args - CLI arguments
+ * @param {Object} config - Command config from CLI
+ */
+async function installCommand(args, config) {
+  const chalk = require('chalk');
+  const boxen = require('boxen');
+
+  const isYes = args.includes('--yes') || args.includes('-y');
+  const isAll = args.includes('--all');
+  const agentFlags = [];
+
+  // Parse --agent flags
+  for (let i = 0; i < args.length; i++) {
+    if ((args[i] === '--agent' || args[i] === '-a') && args[i + 1]) {
+      agentFlags.push(args[i + 1]);
+      i++;
+    }
+  }
+
+  // Always install at user level (home directory) to protect licensed content
+  const baseDir = os.homedir();
+
+  // Find skills from the package
+  const packageDir = config.packageDir || path.dirname(__dirname);
+  const skillsSourceDir = path.join(packageDir, 'skills');
+
+  if (!fs.existsSync(skillsSourceDir)) {
+    console.error(chalk.red('Skills directory not found. Try reinstalling the package.'));
+    process.exit(1);
+  }
+
+  // Read available skills
+  const skillDirs = fs
+    .readdirSync(skillsSourceDir, { withFileTypes: true })
+    .filter((d) => d.isDirectory() && fs.existsSync(path.join(skillsSourceDir, d.name, 'SKILL.md')))
+    .map((d) => d.name);
+
+  // Header
+  console.log(
+    boxen(
+      chalk.bold.cyan('BI Agent Superpowers') +
+        chalk.gray(` v${config.version}`) +
+        '\n' +
+        chalk.gray('Multi-agent skill installer'),
+      {
+        padding: 1,
+        borderStyle: 'round',
+        borderColor: 'cyan',
+      }
+    )
+  );
+
+  console.log(chalk.gray(`  Install path: ~/${UNIVERSAL_DIR}/`));
+  console.log(chalk.gray(`  Skills: ${skillDirs.length} available\n`));
+
+  // Determine which agents to install for
+  let selectedAgents;
+
+  if (isAll) {
+    selectedAgents = Object.keys(AGENTS);
+  } else if (agentFlags.length > 0) {
+    selectedAgents = agentFlags.filter((a) => AGENTS[a]);
+    const unknown = agentFlags.filter((a) => !AGENTS[a]);
+    if (unknown.length > 0) {
+      console.log(chalk.yellow(`  Unknown agents: ${unknown.join(', ')}`));
+      console.log(chalk.gray(`  Available: ${Object.keys(AGENTS).join(', ')}\n`));
+    }
+  } else if (isYes) {
+    selectedAgents = Object.keys(AGENTS);
+  } else {
+    // Interactive mode: detect and ask
+    const detected = detectAgents(baseDir);
+
+    console.log(chalk.cyan('  Select agents to install for:\n'));
+
+    const items = Object.entries(AGENTS).map(([id, agent]) => ({
+      id,
+      name: detected.includes(id) ? `${agent.name} ${chalk.green('(detected)')}` : agent.name,
+    }));
+
+    const rl = createReadline();
+    try {
+      selectedAgents = await selectMultiple(rl, items, detected);
+    } finally {
+      rl.close();
+    }
+  }
+
+  if (selectedAgents.length === 0) {
+    console.log(chalk.yellow('\n  No agents selected. Nothing to install.'));
+    return;
+  }
+
+  console.log(
+    chalk.cyan(`\n  Installing ${skillDirs.length} skills for ${selectedAgents.length} agents...\n`)
+  );
+
+  // Always install to universal path first
+  const universalTarget = path.join(baseDir, UNIVERSAL_DIR);
+  let installedCount = 0;
+
+  for (const skill of skillDirs) {
+    const src = path.join(skillsSourceDir, skill);
+    const dest = path.join(universalTarget, skill);
+    copySkillDir(src, dest);
+    installedCount++;
+  }
+
+  // List agents whose default dir is the universal path (e.g. Codex)
+  const universalAgents = selectedAgents
+    .filter((id) => AGENTS[id] && AGENTS[id].dir === UNIVERSAL_DIR)
+    .map((id) => AGENTS[id].name);
+  const universalSuffix = universalAgents.length > 0 ? ` — ${universalAgents.join(', ')}` : '';
+  console.log(chalk.green(`  ✓ ${UNIVERSAL_DIR}/ (${installedCount} skills)${universalSuffix}`));
+
+  // Symlink agent-specific directories to universal path
+  const agentResults = [];
+  for (const agentId of selectedAgents) {
+    const agent = AGENTS[agentId];
+    if (agent.dir === UNIVERSAL_DIR) continue; // Already handled
+
+    const agentTarget = path.join(baseDir, agent.dir);
+
+    // If the directory already exists and is not a symlink, copy instead
+    if (fs.existsSync(agentTarget) && !fs.lstatSync(agentTarget).isSymbolicLink()) {
+      // Copy skills into existing directory
+      for (const skill of skillDirs) {
+        copySkillDir(path.join(skillsSourceDir, skill), path.join(agentTarget, skill));
+      }
+      agentResults.push({ agent: agent.name, method: 'copied', dir: agent.dir });
+    } else {
+      // Create symlink to universal directory
+      const parentDir = path.dirname(agentTarget);
+      if (!fs.existsSync(parentDir)) {
+        fs.mkdirSync(parentDir, { recursive: true });
+      }
+
+      // Remove existing symlink if present
+      if (fs.existsSync(agentTarget)) {
+        fs.unlinkSync(agentTarget);
+      }
+
+      try {
+        // Relative symlink from agent dir to universal dir
+        const relPath = path.relative(parentDir, universalTarget);
+        fs.symlinkSync(relPath, agentTarget);
+        agentResults.push({ agent: agent.name, method: 'symlinked', dir: agent.dir });
+      } catch (_e) {
+        // Fallback to copy if symlink fails (e.g. Windows without admin)
+        if (!fs.existsSync(agentTarget)) {
+          fs.mkdirSync(agentTarget, { recursive: true });
+        }
+        for (const skill of skillDirs) {
+          copySkillDir(path.join(skillsSourceDir, skill), path.join(agentTarget, skill));
+        }
+        agentResults.push({ agent: agent.name, method: 'copied', dir: agent.dir });
+      }
+    }
+  }
+
+  // Print results
+  for (const result of agentResults) {
+    const icon = result.method === 'symlinked' ? '→' : '✓';
+    console.log(chalk.green(`  ${icon} ${result.dir}/ (${result.method}) — ${result.agent}`));
+  }
+
+  // Summary
+  const totalAgents = agentResults.length + 1; // +1 for universal
+  console.log(
+    boxen(
+      chalk.green.bold(`Installed ${installedCount} skills for ${totalAgents} agents`) +
+        '\n\n' +
+        chalk.gray('Skills are ready to use. Open your AI agent and start prompting.') +
+        '\n' +
+        chalk.gray('Example: "Help me write a DAX measure for YTD sales"'),
+      {
+        padding: 1,
+        margin: { top: 1 },
+        borderStyle: 'round',
+        borderColor: 'green',
+      }
+    )
+  );
+}
+
+module.exports = installCommand;

package/bin/lib/microsoft-mcp.js

@@ -13,9 +13,11 @@ const path = require('path');
 
 const REMOTE_POWERBI_URL = 'https://api.fabric.microsoft.com/v1/mcp/powerbi';
 const FABRIC_MCP_PACKAGE = '@microsoft/fabric-mcp@latest';
+const MICROSOFT_LEARN_URL = 'https://learn.microsoft.com/api/mcp';
 const MODELING_SERVER_NAME = 'powerbi-modeling-mcp';
 const REMOTE_SERVER_NAME = 'powerbi-remote';
 const FABRIC_SERVER_NAME = 'fabric-mcp-server';
+const LEARN_SERVER_NAME = 'microsoft-learn';
 const ABSOLUTE_LAUNCHER_MODE = 'absolute';
 const PLUGIN_ROOT_LAUNCHER_MODE = 'plugin-root';
 
@@ -63,6 +65,10 @@ function createPluginMcpConfig(options = {}) {
       command: 'node',
       args: [launcherPath],
     },
+    [LEARN_SERVER_NAME]: {
+      type: 'http',
+      url: MICROSOFT_LEARN_URL,
+    },
   };
 }
 
@@ -166,9 +172,11 @@ module.exports = {
   PLUGIN_ROOT_LAUNCHER_MODE,
   REMOTE_POWERBI_URL,
   FABRIC_MCP_PACKAGE,
+  MICROSOFT_LEARN_URL,
   MODELING_SERVER_NAME,
   REMOTE_SERVER_NAME,
   FABRIC_SERVER_NAME,
+  LEARN_SERVER_NAME,
   resolveModelingLauncherPath,
   createPluginMcpConfig,
   createMcpConfigForFormat,

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

@@ -11,6 +11,7 @@ const {
   PLUGIN_ROOT_LAUNCHER_MODE,
   REMOTE_POWERBI_URL,
   FABRIC_MCP_PACKAGE,
+  MICROSOFT_LEARN_URL,
   createPluginMcpConfig,
   createMcpConfigForFormat,
   mergeMcpConfig,
@@ -58,6 +59,10 @@ describe('createPluginMcpConfig', () => {
     assert.strictEqual(config['powerbi-modeling-mcp'].type, 'stdio');
     assert.strictEqual(config['powerbi-modeling-mcp'].command, 'node');
     assert.ok(config['powerbi-modeling-mcp'].args[0].endsWith('powerbi-modeling-launcher.js'));
+    assert.deepStrictEqual(config['microsoft-learn'], {
+      type: 'http',
+      url: MICROSOFT_LEARN_URL,
+    });
   });
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luquimbo/bi-superpowers",
-  "version": "1.0.0",
+  "version": "1.1.2",
   "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/contributions/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "contributions"
 description: "Contributions Validation Skill: Contribution validation."
-version: "1.0.0"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/contributions.md instead. -->

package/skills/data-model-design/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "data-model-design"
 description: "Use when the user asks about Data Model Design Skill, especially phrases like \"diseñar modelo de datos\", \"crear modelo Power BI\", \"arquitectura de datos\", \"empezar proyecto BI\", \"nuevo modelo semántico\"."
-version: "1.0.0"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/data-model-design.md instead. -->