@luquimbo/bi-superpowers 4.1.0 → 4.1.1

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "AI-powered skills for Power BI Desktop development. Works with Claude Code, GitHub Copilot, Codex, Gemini CLI, and Kilo Code.",
-    "version": "4.1.0",
+    "version": "4.1.1",
     "repository": "https://github.com/luquimbo/bi-superpowers"
   },
   "plugins": [

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

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

@@ -1,6 +1,6 @@
 {
   "name": "bi-superpowers",
-  "version": "4.1.0",
+  "version": "4.1.1",
   "skillCount": 4,
   "skills": [
     {

package/.plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "spec": "open-plugin-spec@1",
   "name": "bi-superpowers",
-  "version": "4.1.0",
+  "version": "4.1.1",
   "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/AGENTS.md

@@ -127,18 +127,18 @@ npm install -g @luquimbo/bi-superpowers
 super install
 ```
 
-The shared v4.0.0 contract is:
+The shared v4.1.0 contract is:
 - **4 skills** — `bi-start` (session opener), `project-kickoff`, `pbi-connect`, `report-design`
 - **2 MCP servers** — `powerbi-modeling-mcp`, `microsoft-learn`
 
 Agent-specific behavior:
-- **Claude Code** — `super kickoff` can also generate a project-local plugin with slash commands: `/project-kickoff`, `/pbi-connect`, `/report-design`
+- **Claude Code** — `super kickoff` can also generate a project-local plugin with slash commands: `/bi-start`, `/project-kickoff`, `/pbi-connect`, `/report-design`
 - **GitHub Copilot** — uses the installed skills + MCP config via natural-language prompts
 - **Codex** — uses the installed skills + MCP config via natural-language prompts
 - **Gemini CLI** — uses the installed skills + MCP config via natural-language prompts
 - **Kilo Code** — uses the installed skills + MCP config via natural-language prompts
 
-`/report-design` has one extra runtime prerequisite on every agent: **Windows + Power BI Desktop + Python 3.10+ + `pipx` + `pbi-cli-tool`**. If that CLI stack is not available yet, start with `project-kickoff` and `pbi-connect`.
+`/report-design` has one extra runtime prerequisite on every agent: **Windows + Power BI Desktop**. `pbi-cli-tool` is optional for model introspection only; the PBIR authoring flow is driven by the bundled Node scripts. If that Desktop stack is not available yet, start with `bi-start`, `project-kickoff`, or `pbi-connect`.
 
 ### Claude Desktop
 
@@ -175,13 +175,14 @@ Los 4 skills quedan disponibles como MCP prompts.
 - **No Laziness**: Fix root causes, avoid temporary patches.
 - **Minimal Impact**: Touch only what is necessary.
 
-## Available Skills (3)
+## Available Skills (4)
 
 | Skill | Purpose | Trigger |
 |-------|---------|---------|
+| `/bi-start` | Session opener: environment snapshot, update check, and routing to the specialist skills | "bi-start", "empezar", "start session" |
 | `/project-kickoff` | Analyze and plan BI projects | "analyze project", "new project" |
 | `/pbi-connect` | Connect to Power BI Desktop | "connect Power BI", "MCP" |
-| `/report-design` | Generate PBIR report pages via `pbi-cli-tool` | "report design", "crear reportes" |
+| `/report-design` | Generate PBIR report pages via bundled Node scripts | "report design", "crear reportes" |
 
 ## MCP Servers (2)
 
@@ -209,7 +210,7 @@ BI Agent Superpowers generates a native Claude Code plugin from a single source
 project/
 ├── .claude-plugin/plugin.json   # Plugin manifest
 ├── .mcp.json                    # Power BI Modeling + Microsoft Learn MCPs
-├── commands/*.md                # 3 slash commands (pbi-connect, project-kickoff, report-design)
+├── commands/*.md                # 4 slash commands (bi-start, pbi-connect, project-kickoff, report-design)
 ├── skills/*/SKILL.md            # 4 skills (discoverable)
 ├── config.json                  # User preferences
 └── library/ → symlink           # Snippets, templates, themes

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [4.1.0] — 2026-04-21
 
+> **First stable release — the de-facto 1.0 of `@luquimbo/bi-superpowers`.**
+>
+> Versions 2.x, 3.x, and 4.0.0 were iteration cycles while the plugin's
+> scope, architecture, and install UX were settling. The v4.1.0 line is
+> the first release the author considers ready for real use: the 4
+> skills + 2 MCPs are stable, both install paths (Claude Code marketplace
+> and npm + `super install`) are documented, the cross-agent autoupdate
+> loop is working end-to-end, and the Opus 4.7 1M code review report
+> with all its blockers + high findings is resolved in the tree. Pre-4.1
+> versions on npm should be treated as pre-release history.
+>
+> (The version number stays on the 4.x line because npm is strictly
+> monotonic and the numeric identity would be confusing to rewrite; the
+> README, CHANGELOG, and this note carry the "first stable" framing.)
+
 ### Added
 
 - **New skill: `/bi-start`** — session-opener that every new chat conversation can

package/README.md

@@ -7,7 +7,9 @@
 
 Toolkit open-source para trabajar con **Power BI Desktop** desde Claude Code, GitHub Copilot, Codex, Gemini CLI y Kilo Code.
 
-> **Estado:** `v4.0.x`. Incluye 4 skills (`/bi-start` + 3 especialistas) y 2 MCP servers oficiales de Microsoft. `/report-design` genera PBIR via scripts Node propios (no depende de `pbi-cli-tool` para authoring — Windows + Power BI Desktop sí sigue siendo requisito runtime).
+> **Estado:** `v4.1.0` — **primera versión estable**. Incluye 4 skills (`/bi-start` + 3 especialistas) y 2 MCP servers oficiales de Microsoft. `/report-design` genera PBIR via scripts Node propios (no depende de `pbi-cli-tool` para authoring — Windows + Power BI Desktop sí sigue siendo requisito runtime).
+>
+> _Nota de versionado_: las versiones 2.x, 3.x y 4.0.0 fueron iteraciones mientras el alcance y la arquitectura del plugin se estaban asentando. **Tratá a v4.1.x como si fuera la 1.0** del producto — es el primer release que el autor considera listo para uso real. El numeral se queda en la línea 4.x porque npm es estrictamente monotónico (no se puede bajar el número), pero la madurez del producto arranca acá.
 
 ---
 

package/bin/commands/update-check.js

@@ -44,6 +44,10 @@ const https = require('https');
 const PACKAGE_NAME = '@luquimbo/bi-superpowers';
 const CACHE_TTL_MS = 1000 * 60 * 60 * 24; // 24 hours
 const HTTPS_TIMEOUT_MS = 5000;
+// Rewritten at generation time when this helper is copied into
+// `skills/<name>/scripts/update-check.js`. In the canonical source under
+// `bin/commands/`, it stays null and we fall back to package.json.
+const BUNDLED_INSTALLED_VERSION = null;
 
 // ---------------------------------------------------------------------------
 // Argument parsing
@@ -60,6 +64,7 @@ function parseArgs(argv) {
     help: false,
     stateDir: null,
     packageName: null,
+    installedVersion: null,
   };
   for (let i = 0; i < argv.length; i += 1) {
     const a = argv[i];
@@ -71,6 +76,7 @@ function parseArgs(argv) {
     else if (a === '--reset') out.reset = true;
     else if (a === '--state-dir') out.stateDir = argv[++i];
     else if (a === '--package-name') out.packageName = argv[++i];
+    else if (a === '--installed-version') out.installedVersion = argv[++i];
     else if (a === '-h' || a === '--help') out.help = true;
     else {
       process.stderr.write(`update-check: unknown flag: ${a}\n`);
@@ -96,6 +102,7 @@ function help() {
       '  --reset                 Delete the state file (used after a successful upgrade)',
       '  --state-dir <path>      Override ~/.bi-superpowers/ (tests)',
       '  --package-name <name>   Override the package name (tests)',
+      '  --installed-version <v> Override the installed version (generated skill bundles)',
       '  -h, --help              Show this help',
       '',
     ].join('\n')
@@ -257,7 +264,13 @@ function fetchLatestVersion(packageName) {
 // Installed version — read from our own package.json
 // ---------------------------------------------------------------------------
 
-function readInstalledVersion() {
+function readInstalledVersion(explicitVersion = null) {
+  if (explicitVersion) {
+    return String(explicitVersion);
+  }
+  if (BUNDLED_INSTALLED_VERSION) {
+    return String(BUNDLED_INSTALLED_VERSION);
+  }
   try {
     return require(path.join(__dirname, '..', '..', 'package.json')).version;
   } catch (_) {
@@ -318,7 +331,7 @@ async function main() {
     return;
   }
 
-  const installed = readInstalledVersion();
+  const installed = readInstalledVersion(args.installedVersion);
   if (!installed) {
     // Installed version undetermined — nothing useful to report.
     return;
@@ -376,6 +389,7 @@ module.exports = {
   writeState,
   resetState,
   fetchLatestVersion,
+  readInstalledVersion,
   CACHE_TTL_MS,
   PACKAGE_NAME,
 };

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

@@ -162,6 +162,16 @@ If the command fails (missing binary, permissions, offline), ignore the error an
 
 `;
 
+function shouldIncludeUpdateCheckPreamble(skill, options = {}) {
+  if (options.skipPreamble) {
+    return false;
+  }
+  // bi-start owns the interactive update flow itself in PHASE 0. If we also
+  // prepend the generic passive preamble, the session-opener gets two
+  // competing update contracts in the same skill.
+  return skill.name !== 'bi-start';
+}
+
 /**
  * Build command markdown with Claude Code frontmatter.
  *
@@ -174,7 +184,7 @@ If the command fails (missing binary, permissions, offline), ignore the error an
 function buildCommandMarkdown(skill, libraryPrefix, options = {}) {
   const description = getSkillPurpose(skill.name);
   const content = rewriteLibraryReferences(skill.content, libraryPrefix);
-  const preamble = options.skipPreamble ? '' : UPDATE_CHECK_PREAMBLE;
+  const preamble = shouldIncludeUpdateCheckPreamble(skill, options) ? UPDATE_CHECK_PREAMBLE : '';
 
   return `---
 description: ${toFrontmatterValue(description)}
@@ -197,7 +207,7 @@ ${preamble}${content}`;
  */
 function buildSkillMarkdown(skill, version, libraryPrefix, options = {}) {
   const content = rewriteLibraryReferences(skill.content, libraryPrefix);
-  const preamble = options.skipPreamble ? '' : UPDATE_CHECK_PREAMBLE;
+  const preamble = shouldIncludeUpdateCheckPreamble(skill, options) ? UPDATE_CHECK_PREAMBLE : '';
 
   return `---
 name: ${toFrontmatterValue(skill.name)}
@@ -221,14 +231,22 @@ ${preamble}${content}`;
  * @param {string} targetDir - plugin target root (contains skills/<name>/)
  * @param {Object[]} skills - Skills to wire the script into
  */
-function copyUpdateCheckScript(packageDir, targetDir, skills) {
+function copyUpdateCheckScript(packageDir, targetDir, skills, version = null) {
   if (!packageDir) return;
   const src = path.join(packageDir, 'bin', 'commands', 'update-check.js');
   if (!fs.existsSync(src)) return;
+  const sourceContent = fs.readFileSync(src, 'utf8');
+  let bundledContent = sourceContent;
+  if (version) {
+    bundledContent = sourceContent.replace(
+      'const BUNDLED_INSTALLED_VERSION = null;',
+      `const BUNDLED_INSTALLED_VERSION = ${JSON.stringify(version)};`
+    );
+  }
   for (const skill of skills) {
     const scriptsDir = path.join(targetDir, 'skills', skill.name, 'scripts');
     ensureDirectory(scriptsDir);
-    fs.copyFileSync(src, path.join(scriptsDir, 'update-check.js'));
+    fs.writeFileSync(path.join(scriptsDir, 'update-check.js'), bundledContent);
   }
 }
 
@@ -453,7 +471,7 @@ async function generate(targetDir, skills, options = {}) {
   // Ship the update-check helper alongside every skill so the SKILL.md
   // preamble can invoke it via `{skillBundleDir}/scripts/update-check.js`
   // regardless of install path.
-  copyUpdateCheckScript(options.packageDir, targetDir, skills);
+  copyUpdateCheckScript(options.packageDir, targetDir, skills, version);
 
   console.log('  ✓ Created Claude Code plugin manifest');
   console.log('  ✓ Created .mcp.json with official Microsoft MCP servers');

package/commands/bi-start.md

@@ -4,27 +4,6 @@ description: "Session opener — environment snapshot, update check, and routing
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/bi-start.md instead. -->
 
-<!-- bi-superpowers update-check preamble (auto-generated, do not edit) -->
-## ⬆ Update check
-
-Before handling the user's request below, run this command **once per conversation** and interpret the output:
-
-```bash
-node "{skillBundleDir}/scripts/update-check.js" --silent-if-uptodate --silent-if-snoozed
-```
-
-- 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."
-
-  Then continue with the skill below.
-- `SNOOZED <iso>` — proceed silently.
-
-If the command fails (missing binary, permissions, offline), ignore the error and proceed with the skill. The update check must never block the user's request.
-
----
-<!-- /bi-superpowers update-check preamble -->
-
 # BI Start Skill
 
 ## Trigger
@@ -48,7 +27,7 @@ You are the session-opener, **not** the project-opener. If the user's intent is
 ## MANDATORY RULES
 
 1. **ONE QUESTION AT A TIME.** Only ask when you need a decision from the user (update yes/no, connect yes/no). Never stack multiple questions.
-2. **INFORMATIVE MENU — DON'T FORCE A CHOICE.** Show the 3 skills as a table with 1-line descriptions. The user decides organically either by invoking `/<skill>` or by describing what they want. Do NOT say "pick 1, 2, or 3" — that's quiz-style and annoying for returning users.
+2. **INFORMATIVE MENU — DON'T FORCE A CHOICE.** You are already inside `/bi-start`. Show the **3 specialist skills** as a table with 1-line descriptions. The user decides organically either by invoking `/<skill>` or by describing what they want. Do NOT say "pick 1, 2, or 3" — that's quiz-style and annoying for returning users.
 3. **PROACTIVE ON UPDATE + CONNECT.** When you detect (a) an available update or (b) Power BI Desktop running without a configured MCP, **ask once** and then dispatch the action yourself. Don't force the user to remember the exact command.
 4. **SAFE DEFAULTS ON SAY-NOTHING.** If the user greets you and then goes silent, show the menu and stop. Don't auto-dispatch anything without an explicit "sí" / "yes".
 5. **OS-AWARE, NOT OS-GATING.** Works on any OS. Mark Windows-only skills clearly. On macOS/Linux, `/project-kickoff` still has partial value (writes `AGENTS.md` and stops); mention that honestly instead of refusing.
@@ -131,10 +110,10 @@ Keep it 3-4 lines. The point is situational awareness, not a status page.
 
 ## PHASE 2: Skills menu (informativo)
 
-Show the 3 skills as a table. Plain, no prompt. Do NOT number them or ask "which one?".
+Remind the user that `/bi-start` is the session opener, then show the **3 specialist skills** as a table. Plain, no prompt. Do NOT number them or ask "which one?".
 
 ```
-Skills disponibles:
+Ya estás en `/bi-start` (session opener). Los 3 specialist skills disponibles son:
 
   /project-kickoff   Arrancar un proyecto BI nuevo (crea AGENTS.md, plantea modelo)      · Win / Mac / Linux (parcial fuera de Win)
   /pbi-connect       Conectar el agente a Power BI Desktop vía MCP                       · Windows
@@ -190,7 +169,7 @@ On macOS/Linux, skip Case B and Case C — mention once:
 
 If you got here without dispatching, close with:
 
-> _"Listo — invocá el skill que necesites, o pedime ayuda específica sobre cualquiera de los 3. Si abrís una sesión nueva mañana, `/bi-start` te orienta de nuevo."_
+> _"Listo — invocá el specialist skill que necesites, o pedime ayuda específica sobre cualquiera de esos 3. Si abrís una sesión nueva mañana, `/bi-start` te orienta de nuevo."_
 
 Stop. Don't hover. The user will tell you what they want next.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luquimbo/bi-superpowers",
-  "version": "4.1.0",
+  "version": "4.1.1",
   "description": "Open-source Power BI Desktop toolkit for Claude Code, GitHub Copilot, Codex, Gemini CLI, and Kilo Code. Ships 4 skills and 2 official Microsoft MCP servers.",
   "main": "bin/cli.js",
   "bin": {

package/skills/bi-start/SKILL.md

@@ -1,32 +1,11 @@
 ---
 name: "bi-start"
 description: "Use when the user asks about BI Start Skill, especially phrases like \"bi-start\", \"bi start\", \"/bi-start\", \"empezar\", \"comenzar\", \"arranco\"."
-version: "4.1.0"
+version: "4.1.1"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/bi-start.md instead. -->
 
-<!-- bi-superpowers update-check preamble (auto-generated, do not edit) -->
-## ⬆ Update check
-
-Before handling the user's request below, run this command **once per conversation** and interpret the output:
-
-```bash
-node "{skillBundleDir}/scripts/update-check.js" --silent-if-uptodate --silent-if-snoozed
-```
-
-- 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."
-
-  Then continue with the skill below.
-- `SNOOZED <iso>` — proceed silently.
-
-If the command fails (missing binary, permissions, offline), ignore the error and proceed with the skill. The update check must never block the user's request.
-
----
-<!-- /bi-superpowers update-check preamble -->
-
 # BI Start Skill
 
 ## Trigger
@@ -50,7 +29,7 @@ You are the session-opener, **not** the project-opener. If the user's intent is
 ## MANDATORY RULES
 
 1. **ONE QUESTION AT A TIME.** Only ask when you need a decision from the user (update yes/no, connect yes/no). Never stack multiple questions.
-2. **INFORMATIVE MENU — DON'T FORCE A CHOICE.** Show the 3 skills as a table with 1-line descriptions. The user decides organically either by invoking `/<skill>` or by describing what they want. Do NOT say "pick 1, 2, or 3" — that's quiz-style and annoying for returning users.
+2. **INFORMATIVE MENU — DON'T FORCE A CHOICE.** You are already inside `/bi-start`. Show the **3 specialist skills** as a table with 1-line descriptions. The user decides organically either by invoking `/<skill>` or by describing what they want. Do NOT say "pick 1, 2, or 3" — that's quiz-style and annoying for returning users.
 3. **PROACTIVE ON UPDATE + CONNECT.** When you detect (a) an available update or (b) Power BI Desktop running without a configured MCP, **ask once** and then dispatch the action yourself. Don't force the user to remember the exact command.
 4. **SAFE DEFAULTS ON SAY-NOTHING.** If the user greets you and then goes silent, show the menu and stop. Don't auto-dispatch anything without an explicit "sí" / "yes".
 5. **OS-AWARE, NOT OS-GATING.** Works on any OS. Mark Windows-only skills clearly. On macOS/Linux, `/project-kickoff` still has partial value (writes `AGENTS.md` and stops); mention that honestly instead of refusing.
@@ -133,10 +112,10 @@ Keep it 3-4 lines. The point is situational awareness, not a status page.
 
 ## PHASE 2: Skills menu (informativo)
 
-Show the 3 skills as a table. Plain, no prompt. Do NOT number them or ask "which one?".
+Remind the user that `/bi-start` is the session opener, then show the **3 specialist skills** as a table. Plain, no prompt. Do NOT number them or ask "which one?".
 
 ```
-Skills disponibles:
+Ya estás en `/bi-start` (session opener). Los 3 specialist skills disponibles son:
 
   /project-kickoff   Arrancar un proyecto BI nuevo (crea AGENTS.md, plantea modelo)      · Win / Mac / Linux (parcial fuera de Win)
   /pbi-connect       Conectar el agente a Power BI Desktop vía MCP                       · Windows
@@ -192,7 +171,7 @@ On macOS/Linux, skip Case B and Case C — mention once:
 
 If you got here without dispatching, close with:
 
-> _"Listo — invocá el skill que necesites, o pedime ayuda específica sobre cualquiera de los 3. Si abrís una sesión nueva mañana, `/bi-start` te orienta de nuevo."_
+> _"Listo — invocá el specialist skill que necesites, o pedime ayuda específica sobre cualquiera de esos 3. Si abrís una sesión nueva mañana, `/bi-start` te orienta de nuevo."_
 
 Stop. Don't hover. The user will tell you what they want next.
 

package/skills/bi-start/scripts/update-check.js

@@ -44,6 +44,10 @@ const https = require('https');
 const PACKAGE_NAME = '@luquimbo/bi-superpowers';
 const CACHE_TTL_MS = 1000 * 60 * 60 * 24; // 24 hours
 const HTTPS_TIMEOUT_MS = 5000;
+// Rewritten at generation time when this helper is copied into
+// `skills/<name>/scripts/update-check.js`. In the canonical source under
+// `bin/commands/`, it stays null and we fall back to package.json.
+const BUNDLED_INSTALLED_VERSION = "4.1.1";
 
 // ---------------------------------------------------------------------------
 // Argument parsing
@@ -60,6 +64,7 @@ function parseArgs(argv) {
     help: false,
     stateDir: null,
     packageName: null,
+    installedVersion: null,
   };
   for (let i = 0; i < argv.length; i += 1) {
     const a = argv[i];
@@ -71,6 +76,7 @@ function parseArgs(argv) {
     else if (a === '--reset') out.reset = true;
     else if (a === '--state-dir') out.stateDir = argv[++i];
     else if (a === '--package-name') out.packageName = argv[++i];
+    else if (a === '--installed-version') out.installedVersion = argv[++i];
     else if (a === '-h' || a === '--help') out.help = true;
     else {
       process.stderr.write(`update-check: unknown flag: ${a}\n`);
@@ -96,6 +102,7 @@ function help() {
       '  --reset                 Delete the state file (used after a successful upgrade)',
       '  --state-dir <path>      Override ~/.bi-superpowers/ (tests)',
       '  --package-name <name>   Override the package name (tests)',
+      '  --installed-version <v> Override the installed version (generated skill bundles)',
       '  -h, --help              Show this help',
       '',
     ].join('\n')
@@ -257,7 +264,13 @@ function fetchLatestVersion(packageName) {
 // Installed version — read from our own package.json
 // ---------------------------------------------------------------------------
 
-function readInstalledVersion() {
+function readInstalledVersion(explicitVersion = null) {
+  if (explicitVersion) {
+    return String(explicitVersion);
+  }
+  if (BUNDLED_INSTALLED_VERSION) {
+    return String(BUNDLED_INSTALLED_VERSION);
+  }
   try {
     return require(path.join(__dirname, '..', '..', 'package.json')).version;
   } catch (_) {
@@ -318,7 +331,7 @@ async function main() {
     return;
   }
 
-  const installed = readInstalledVersion();
+  const installed = readInstalledVersion(args.installedVersion);
   if (!installed) {
     // Installed version undetermined — nothing useful to report.
     return;
@@ -376,6 +389,7 @@ module.exports = {
   writeState,
   resetState,
   fetchLatestVersion,
+  readInstalledVersion,
   CACHE_TTL_MS,
   PACKAGE_NAME,
 };

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\", \"PBI connection\", \"MCP connection\", \"Power BI MCP\", \"modeling mcp\", \"Power BI Modeling MCP\"."
-version: "4.1.0"
+version: "4.1.1"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/pbi-connect.md instead. -->

package/skills/pbi-connect/scripts/update-check.js

@@ -44,6 +44,10 @@ const https = require('https');
 const PACKAGE_NAME = '@luquimbo/bi-superpowers';
 const CACHE_TTL_MS = 1000 * 60 * 60 * 24; // 24 hours
 const HTTPS_TIMEOUT_MS = 5000;
+// Rewritten at generation time when this helper is copied into
+// `skills/<name>/scripts/update-check.js`. In the canonical source under
+// `bin/commands/`, it stays null and we fall back to package.json.
+const BUNDLED_INSTALLED_VERSION = "4.1.1";
 
 // ---------------------------------------------------------------------------
 // Argument parsing
@@ -60,6 +64,7 @@ function parseArgs(argv) {
     help: false,
     stateDir: null,
     packageName: null,
+    installedVersion: null,
   };
   for (let i = 0; i < argv.length; i += 1) {
     const a = argv[i];
@@ -71,6 +76,7 @@ function parseArgs(argv) {
     else if (a === '--reset') out.reset = true;
     else if (a === '--state-dir') out.stateDir = argv[++i];
     else if (a === '--package-name') out.packageName = argv[++i];
+    else if (a === '--installed-version') out.installedVersion = argv[++i];
     else if (a === '-h' || a === '--help') out.help = true;
     else {
       process.stderr.write(`update-check: unknown flag: ${a}\n`);
@@ -96,6 +102,7 @@ function help() {
       '  --reset                 Delete the state file (used after a successful upgrade)',
       '  --state-dir <path>      Override ~/.bi-superpowers/ (tests)',
       '  --package-name <name>   Override the package name (tests)',
+      '  --installed-version <v> Override the installed version (generated skill bundles)',
       '  -h, --help              Show this help',
       '',
     ].join('\n')
@@ -257,7 +264,13 @@ function fetchLatestVersion(packageName) {
 // Installed version — read from our own package.json
 // ---------------------------------------------------------------------------
 
-function readInstalledVersion() {
+function readInstalledVersion(explicitVersion = null) {
+  if (explicitVersion) {
+    return String(explicitVersion);
+  }
+  if (BUNDLED_INSTALLED_VERSION) {
+    return String(BUNDLED_INSTALLED_VERSION);
+  }
   try {
     return require(path.join(__dirname, '..', '..', 'package.json')).version;
   } catch (_) {
@@ -318,7 +331,7 @@ async function main() {
     return;
   }
 
-  const installed = readInstalledVersion();
+  const installed = readInstalledVersion(args.installedVersion);
   if (!installed) {
     // Installed version undetermined — nothing useful to report.
     return;
@@ -376,6 +389,7 @@ module.exports = {
   writeState,
   resetState,
   fetchLatestVersion,
+  readInstalledVersion,
   CACHE_TTL_MS,
   PACKAGE_NAME,
 };

package/skills/project-kickoff/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "project-kickoff"
 description: "Use when the user asks about Project Kickoff Skill, especially phrases like \"I'm starting a brand-new BI project from scratch\", \"analizar proyecto\", \"analyze project\", \"project kickoff\", \"nuevo proyecto\", \"new project\"."
-version: "4.1.0"
+version: "4.1.1"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/project-kickoff.md instead. -->

package/skills/project-kickoff/scripts/update-check.js

@@ -44,6 +44,10 @@ const https = require('https');
 const PACKAGE_NAME = '@luquimbo/bi-superpowers';
 const CACHE_TTL_MS = 1000 * 60 * 60 * 24; // 24 hours
 const HTTPS_TIMEOUT_MS = 5000;
+// Rewritten at generation time when this helper is copied into
+// `skills/<name>/scripts/update-check.js`. In the canonical source under
+// `bin/commands/`, it stays null and we fall back to package.json.
+const BUNDLED_INSTALLED_VERSION = "4.1.1";
 
 // ---------------------------------------------------------------------------
 // Argument parsing
@@ -60,6 +64,7 @@ function parseArgs(argv) {
     help: false,
     stateDir: null,
     packageName: null,
+    installedVersion: null,
   };
   for (let i = 0; i < argv.length; i += 1) {
     const a = argv[i];
@@ -71,6 +76,7 @@ function parseArgs(argv) {
     else if (a === '--reset') out.reset = true;
     else if (a === '--state-dir') out.stateDir = argv[++i];
     else if (a === '--package-name') out.packageName = argv[++i];
+    else if (a === '--installed-version') out.installedVersion = argv[++i];
     else if (a === '-h' || a === '--help') out.help = true;
     else {
       process.stderr.write(`update-check: unknown flag: ${a}\n`);
@@ -96,6 +102,7 @@ function help() {
       '  --reset                 Delete the state file (used after a successful upgrade)',
       '  --state-dir <path>      Override ~/.bi-superpowers/ (tests)',
       '  --package-name <name>   Override the package name (tests)',
+      '  --installed-version <v> Override the installed version (generated skill bundles)',
       '  -h, --help              Show this help',
       '',
     ].join('\n')
@@ -257,7 +264,13 @@ function fetchLatestVersion(packageName) {
 // Installed version — read from our own package.json
 // ---------------------------------------------------------------------------
 
-function readInstalledVersion() {
+function readInstalledVersion(explicitVersion = null) {
+  if (explicitVersion) {
+    return String(explicitVersion);
+  }
+  if (BUNDLED_INSTALLED_VERSION) {
+    return String(BUNDLED_INSTALLED_VERSION);
+  }
   try {
     return require(path.join(__dirname, '..', '..', 'package.json')).version;
   } catch (_) {
@@ -318,7 +331,7 @@ async function main() {
     return;
   }
 
-  const installed = readInstalledVersion();
+  const installed = readInstalledVersion(args.installedVersion);
   if (!installed) {
     // Installed version undetermined — nothing useful to report.
     return;
@@ -376,6 +389,7 @@ module.exports = {
   writeState,
   resetState,
   fetchLatestVersion,
+  readInstalledVersion,
   CACHE_TTL_MS,
   PACKAGE_NAME,
 };

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 \"crear reportes\", \"armar el reporte\", \"diseñar reporte\", \"report design\", \"create reports\", \"build dashboard\"."
-version: "4.1.0"
+version: "4.1.1"
 ---
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/report-design.md instead. -->

package/skills/report-design/scripts/update-check.js

@@ -44,6 +44,10 @@ const https = require('https');
 const PACKAGE_NAME = '@luquimbo/bi-superpowers';
 const CACHE_TTL_MS = 1000 * 60 * 60 * 24; // 24 hours
 const HTTPS_TIMEOUT_MS = 5000;
+// Rewritten at generation time when this helper is copied into
+// `skills/<name>/scripts/update-check.js`. In the canonical source under
+// `bin/commands/`, it stays null and we fall back to package.json.
+const BUNDLED_INSTALLED_VERSION = "4.1.1";
 
 // ---------------------------------------------------------------------------
 // Argument parsing
@@ -60,6 +64,7 @@ function parseArgs(argv) {
     help: false,
     stateDir: null,
     packageName: null,
+    installedVersion: null,
   };
   for (let i = 0; i < argv.length; i += 1) {
     const a = argv[i];
@@ -71,6 +76,7 @@ function parseArgs(argv) {
     else if (a === '--reset') out.reset = true;
     else if (a === '--state-dir') out.stateDir = argv[++i];
     else if (a === '--package-name') out.packageName = argv[++i];
+    else if (a === '--installed-version') out.installedVersion = argv[++i];
     else if (a === '-h' || a === '--help') out.help = true;
     else {
       process.stderr.write(`update-check: unknown flag: ${a}\n`);
@@ -96,6 +102,7 @@ function help() {
       '  --reset                 Delete the state file (used after a successful upgrade)',
       '  --state-dir <path>      Override ~/.bi-superpowers/ (tests)',
       '  --package-name <name>   Override the package name (tests)',
+      '  --installed-version <v> Override the installed version (generated skill bundles)',
       '  -h, --help              Show this help',
       '',
     ].join('\n')
@@ -257,7 +264,13 @@ function fetchLatestVersion(packageName) {
 // Installed version — read from our own package.json
 // ---------------------------------------------------------------------------
 
-function readInstalledVersion() {
+function readInstalledVersion(explicitVersion = null) {
+  if (explicitVersion) {
+    return String(explicitVersion);
+  }
+  if (BUNDLED_INSTALLED_VERSION) {
+    return String(BUNDLED_INSTALLED_VERSION);
+  }
   try {
     return require(path.join(__dirname, '..', '..', 'package.json')).version;
   } catch (_) {
@@ -318,7 +331,7 @@ async function main() {
     return;
   }
 
-  const installed = readInstalledVersion();
+  const installed = readInstalledVersion(args.installedVersion);
   if (!installed) {
     // Installed version undetermined — nothing useful to report.
     return;
@@ -376,6 +389,7 @@ module.exports = {
   writeState,
   resetState,
   fetchLatestVersion,
+  readInstalledVersion,
   CACHE_TTL_MS,
   PACKAGE_NAME,
 };

package/src/content/skills/bi-start.md

@@ -21,7 +21,7 @@ You are the session-opener, **not** the project-opener. If the user's intent is
 ## MANDATORY RULES
 
 1. **ONE QUESTION AT A TIME.** Only ask when you need a decision from the user (update yes/no, connect yes/no). Never stack multiple questions.
-2. **INFORMATIVE MENU — DON'T FORCE A CHOICE.** Show the 3 skills as a table with 1-line descriptions. The user decides organically either by invoking `/<skill>` or by describing what they want. Do NOT say "pick 1, 2, or 3" — that's quiz-style and annoying for returning users.
+2. **INFORMATIVE MENU — DON'T FORCE A CHOICE.** You are already inside `/bi-start`. Show the **3 specialist skills** as a table with 1-line descriptions. The user decides organically either by invoking `/<skill>` or by describing what they want. Do NOT say "pick 1, 2, or 3" — that's quiz-style and annoying for returning users.
 3. **PROACTIVE ON UPDATE + CONNECT.** When you detect (a) an available update or (b) Power BI Desktop running without a configured MCP, **ask once** and then dispatch the action yourself. Don't force the user to remember the exact command.
 4. **SAFE DEFAULTS ON SAY-NOTHING.** If the user greets you and then goes silent, show the menu and stop. Don't auto-dispatch anything without an explicit "sí" / "yes".
 5. **OS-AWARE, NOT OS-GATING.** Works on any OS. Mark Windows-only skills clearly. On macOS/Linux, `/project-kickoff` still has partial value (writes `AGENTS.md` and stops); mention that honestly instead of refusing.
@@ -104,10 +104,10 @@ Keep it 3-4 lines. The point is situational awareness, not a status page.
 
 ## PHASE 2: Skills menu (informativo)
 
-Show the 3 skills as a table. Plain, no prompt. Do NOT number them or ask "which one?".
+Remind the user that `/bi-start` is the session opener, then show the **3 specialist skills** as a table. Plain, no prompt. Do NOT number them or ask "which one?".
 
 ```
-Skills disponibles:
+Ya estás en `/bi-start` (session opener). Los 3 specialist skills disponibles son:
 
   /project-kickoff   Arrancar un proyecto BI nuevo (crea AGENTS.md, plantea modelo)      · Win / Mac / Linux (parcial fuera de Win)
   /pbi-connect       Conectar el agente a Power BI Desktop vía MCP                       · Windows
@@ -163,7 +163,7 @@ On macOS/Linux, skip Case B and Case C — mention once:
 
 If you got here without dispatching, close with:
 
-> _"Listo — invocá el skill que necesites, o pedime ayuda específica sobre cualquiera de los 3. Si abrís una sesión nueva mañana, `/bi-start` te orienta de nuevo."_
+> _"Listo — invocá el specialist skill que necesites, o pedime ayuda específica sobre cualquiera de esos 3. Si abrís una sesión nueva mañana, `/bi-start` te orienta de nuevo."_
 
 Stop. Don't hover. The user will tell you what they want next.