@luquimbo/bi-superpowers 1.1.1 → 1.1.2

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": "1.1.1",
+  "version": "1.1.2",
   "author": {
     "name": "Lucas Sanchez"
   }

package/AGENTS.md

@@ -15,6 +15,70 @@
 - `library/`
 - `config.json`
 
+---
+
+## Publishing to npm (for AI agents)
+
+When the user asks for things like **"publica una nueva versión"**, **"publish a patch"**, **"sube esto a npm"**, **"release v1.2.0"**, follow this flow.
+
+### How publishing works
+
+The repo uses **GitHub Actions** to publish automatically. The `NPM_TOKEN` is stored as a GitHub Secret — never commit it to the repo or use it locally for publishes. The workflow at `.github/workflows/publish.yml` triggers on:
+
+1. **Tag push** (`v*`) — preferred, triggered by pushing a version tag
+2. **GitHub release published** — manual via web UI
+3. **Manual workflow dispatch** — via Actions tab
+
+### Standard publish flow (do this when asked)
+
+1. **Verify clean working tree.** Run `git status` and ensure no uncommitted changes.
+2. **Verify on `main` branch.** If on a feature branch, ask the user if you should merge first.
+3. **Choose the version bump:**
+   - `patch` — bug fixes, doc updates, regenerated artifacts
+   - `minor` — new features, new skills, new commands (backwards compatible)
+   - `major` — breaking changes
+4. **Run the bump:**
+   ```bash
+   npm version patch --no-git-tag-version  # or minor / major
+   ```
+5. **Run the local validations** (these also run in CI, but fail fast locally):
+   ```bash
+   npm run build:plugin
+   npm run lint
+   npm run format:check
+   ```
+6. **Commit with conventional commit message:**
+   ```bash
+   git add package.json package-lock.json [+ any regenerated files]
+   git commit -m "chore: bump version to X.Y.Z"
+   ```
+7. **Create the version tag:**
+   ```bash
+   git tag vX.Y.Z
+   ```
+8. **Push commits and tag together:**
+   ```bash
+   git push origin main --follow-tags
+   ```
+9. **Verify the publish triggered.** Tell the user to check https://github.com/luquimbo/bi-superpowers/actions — within 1-2 minutes the workflow runs and publishes.
+10. **Confirm on npm.** Once the workflow finishes, run `npm view @luquimbo/bi-superpowers version` to confirm the new version is live.
+
+### Critical rules
+
+- **Never run `npm publish` locally.** The token lives in GitHub Secrets, not on developer machines. Local publishes bypass CI checks and history.
+- **Never commit the npm token.** It belongs in `.env` (gitignored) for emergencies, or GitHub Secrets for CI.
+- **Always tag versions with `v` prefix** (e.g., `v1.2.3`, not `1.2.3`). The workflow trigger expects `v*`.
+- **Check for `prepack` regenerations.** The `prepack` script regenerates `skills/*/SKILL.md` and `.claude-plugin/plugin.json` with the new version. If running `npm version` triggers regeneration, commit those files in the same commit.
+- **Don't bump version on feature branches.** Always bump on `main` after merge.
+
+### When something goes wrong
+
+- **Workflow fails because version already exists on npm:** the user already published manually. Bump again.
+- **Workflow fails on lint/format:** run `npm run lint:fix && npm run format` locally, commit, retag, push.
+- **Token expired or revoked:** ask the user to regenerate at https://www.npmjs.com/settings/luquimbo/tokens and update the GitHub Secret at https://github.com/luquimbo/bi-superpowers/settings/secrets/actions
+
+---
+
 AI-powered toolkit for Power BI, Fabric & Excel development.
 
 Developed by **Lucas Sanchez** ([@luquimbo](https://github.com/luquimbo))

package/bin/commands/install.js

@@ -21,24 +21,14 @@ const path = require('path');
 const os = require('os');
 const readline = require('readline');
 
-// Agent registry: each agent's skill directory path (relative to project or home)
-// Based on the Agent Skills specification supported by 45+ agents
+// Agent registry: each agent's skill directory path (relative to home directory)
+// Order matches the interactive installer display order
 const AGENTS = {
-  'claude-code': { name: 'Claude Code', dir: '.claude/skills' },
   'github-copilot': { name: 'GitHub Copilot', dir: '.github/skills' },
+  'claude-code': { name: 'Claude Code', dir: '.claude/skills' },
   codex: { name: 'Codex (OpenAI)', dir: '.agents/skills' },
-  cursor: { name: 'Cursor', dir: '.cursor/skills' },
-  windsurf: { name: 'Windsurf', dir: '.windsurf/skills' },
-  cline: { name: 'Cline', dir: '.cline/skills' },
-  continue: { name: 'Continue', dir: '.continue/skills' },
-  'roo-code': { name: 'Roo Code', dir: '.roo/skills' },
-  augment: { name: 'Augment', dir: '.augment/skills' },
-  amp: { name: 'Amp', dir: '.amp/skills' },
-  kilo: { name: 'Kilo Code', dir: '.kilocode/skills' },
-  opencode: { name: 'OpenCode', dir: '.agents/skills' },
-  openhands: { name: 'OpenHands', dir: '.openhands/skills' },
-  goose: { name: 'Goose', dir: '.goose/skills' },
   'gemini-cli': { name: 'Gemini CLI', dir: '.gemini/skills' },
+  kilo: { name: 'Kilo Code', dir: '.kilocode/skills' },
 };
 
 // Universal path — most agents read from .agents/skills/
@@ -246,7 +236,13 @@ async function installCommand(args, config) {
     copySkillDir(src, dest);
     installedCount++;
   }
-  console.log(chalk.green(`  ✓ ${UNIVERSAL_DIR}/ (${installedCount} skills)`));
+
+  // 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 = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luquimbo/bi-superpowers",
-  "version": "1.1.1",
+  "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.1.1"
+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.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/data-model-design.md instead. -->

package/skills/data-modeling/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "data-modeling"
 description: "Use when the user asks about Data Modeling Skill, especially phrases like \"data model\", \"star schema\", \"fact table\", \"relationship\", \"surrogate key\", \"SCD\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/data-modeling.md instead. -->

package/skills/data-quality/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "data-quality"
 description: "Use when the user asks about Data Quality Skill, especially phrases like \"data quality\", \"check for errors\", \"data profiling\", \"clean data\", \"calidad de datos\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/data-quality.md instead. -->

package/skills/dax/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "dax"
 description: "Use when the user asks about DAX Skill, especially phrases like \"DAX\", \"CALCULATE\", \"time intelligence\", \"SUMX\", \"context transition\", \"Power BI formula\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/dax.md instead. -->

package/skills/dax-doctor/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "dax-doctor"
 description: "Use when the user asks about DAX Doctor Skill, especially phrases like \"debug DAX\", \"wrong result\", \"DAX error\", \"slow measure\", \"context issue\", \"depurar DAX\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/dax-doctor.md instead. -->

package/skills/dax-udf/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "dax-udf"
 description: "Use when the user asks about DAX User-Defined Functions (UDFs), especially phrases like \"UDF\", \"DEFINE FUNCTION\", \"DAX Lib\", \"NAMEOF\", \"reusable DAX\", \"VAL parameter\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/dax-udf.md instead. -->

package/skills/deployment/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "deployment"
 description: "Use when the user asks about Deployment Skill, especially phrases like \"deploy\", \"CI/CD\", \"ALM\", \"git integration\", \"environment\", \"desplegar\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/deployment.md instead. -->

package/skills/excel-formulas/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "excel-formulas"
 description: "Use when the user asks about Excel Formulas Skill, especially phrases like \"Excel formula\", \"XLOOKUP\", \"dynamic array\", \"LET formula\", \"named range\", \"conditional formatting formula\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/excel-formulas.md instead. -->

package/skills/fabric-scripts/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "fabric-scripts"
 description: "Use when the user asks about Fabric Scripts Skill, especially phrases like \"Fabric scripts\", \"download dataflows\", \"diagnose connection\", \"TMDL sync\", \"scripts de Fabric\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/fabric-scripts.md instead. -->

package/skills/fast-standard/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "fast-standard"
 description: "Use when the user asks about FAST Standard Skill, especially phrases like \"FAST Standard\", \"financial model\", \"spreadsheet modeling best practices\", \"model audit\", \"calculation block\", \"modelo financiero\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/fast-standard.md instead. -->

package/skills/governance/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "governance"
 description: "Use when the user asks about Governance Skill, especially phrases like \"naming convention\", \"governance\", \"documentation standard\", \"display folder\", \"convención de nombres\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/governance.md instead. -->

package/skills/migration-assistant/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "migration-assistant"
 description: "Use when the user asks about Migration Assistant Skill, especially phrases like \"migrate\", \"move to Fabric\", \"Desktop to PBIP\", \"deprecated feature\", \"migrar\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/migration-assistant.md instead. -->

package/skills/model-documenter/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "model-documenter"
 description: "Use when the user asks about Model Documenter Skill, especially phrases like \"document model\", \"document measures\", \"generate documentation\", \"describe tables\", \"documentar modelo\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/model-documenter.md instead. -->

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: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/pbi-connect.md instead. -->

package/skills/power-query/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "power-query"
 description: "Use when the user asks about Power Query Skill, especially phrases like \"Power Query\", \"query folding\", \"ETL\", \"source connection\", \"refresh\", \"parameters\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/power-query.md instead. -->

package/skills/project-kickoff/SKILL.md

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

package/skills/query-performance/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "query-performance"
 description: "Use when the user asks about Query Performance Skill, especially phrases like \"slow\", \"DAX Studio\", \"taking too long\", \"reduce refresh time\", \"rendimiento\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/query-performance.md instead. -->

package/skills/report-design/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "report-design"
 description: "Use when the user asks about Report Design Skill, especially phrases like \"report design\", \"chart type\", \"IBCS\", \"accessibility\", \"mobile layout\", \"diseño de reporte\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/report-design.md instead. -->

package/skills/report-layout/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "report-layout"
 description: "Use when the user asks about Report Layout Skill, especially phrases like \"report layout\", \"visual placement\", \"report wireframe\", \"navigation design\", \"diseño de reporte\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/report-layout.md instead. -->

package/skills/rls-design/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "rls-design"
 description: "Use when the user asks about RLS Design Skill, especially phrases like \"RLS\", \"user can only see their data\", \"restrict access\", \"security role\", \"seguridad a nivel de fila\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/rls-design.md instead. -->

package/skills/semantic-model/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "semantic-model"
 description: "Use when the user asks about Semantic Model Skill, especially phrases like \"semantic model\", \"TMDL\", \"DirectLake\", \"calculation group\", \"storage mode\", \"modelo semántico\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/semantic-model.md instead. -->

package/skills/testing-validation/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "testing-validation"
 description: "Use when the user asks about Testing & Validation Skill, especially phrases like \"test\", \"unit test DAX\", \"regression test\", \"deployment checklist\", \"data reconciliation\", \"pruebas\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/testing-validation.md instead. -->

package/skills/theme-tweaker/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "theme-tweaker"
 description: "Use when the user asks about Theme Tweaker Skill, especially phrases like \"modificar tema\", \"cambiar colores Power BI\", \"personalizar tema\", \"ajustar estilo\", \"theme tweaker\"."
-version: "1.1.1"
+version: "1.1.2"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/theme-tweaker.md instead. -->