@luquimbo/bi-superpowers 3.2.0 → 4.1.1

package/.claude-plugin/marketplace.json

@@ -6,18 +6,20 @@
   },
   "metadata": {
     "description": "AI-powered skills for Power BI Desktop development. Works with Claude Code, GitHub Copilot, Codex, Gemini CLI, and Kilo Code.",
-    "version": "3.2.0",
+    "version": "4.1.1",
     "repository": "https://github.com/luquimbo/bi-superpowers"
   },
   "plugins": [
     {
       "name": "bi-superpowers",
-      "description": "2 AI skills + Power BI Modeling and Microsoft Learn MCP servers for local Power BI Desktop workflows across 5 AI agents.",
+      "description": "4 AI skills + Power BI Modeling and Microsoft Learn MCP servers for local Power BI Desktop workflows across 5 AI agents.",
       "source": "./",
       "strict": false,
       "skills": [
+        "./skills/bi-start",
         "./skills/pbi-connect",
-        "./skills/project-kickoff"
+        "./skills/project-kickoff",
+        "./skills/report-design"
       ]
     }
   ]

package/.claude-plugin/plugin.json

@@ -1,8 +1,34 @@
 {
   "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.2.0",
+  "version": "4.1.1",
   "author": {
     "name": "Lucas Sanchez"
-  }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/luquimbo/bi-superpowers.git"
+  },
+  "homepage": "https://github.com/luquimbo/bi-superpowers#readme",
+  "license": "MIT",
+  "keywords": [
+    "power-bi",
+    "excel",
+    "dax",
+    "power-query",
+    "mcp",
+    "ai-agent",
+    "business-intelligence",
+    "data-modeling",
+    "semantic-model",
+    "ibcs",
+    "data-visualization",
+    "fabric",
+    "tmdl",
+    "claude-plugin",
+    "claude-code",
+    "claude-desktop",
+    "mcpb",
+    "ai-superpowers"
+  ]
 }

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

@@ -1,23 +1,39 @@
 {
   "name": "bi-superpowers",
-  "version": "3.2.0",
-  "skillCount": 2,
+  "version": "4.1.1",
+  "skillCount": 4,
   "skills": [
+    {
+      "name": "bi-start",
+      "title": "BI Start Skill",
+      "description": "Use when the user asks about BI Start Skill, especially phrases like \"bi-start\", \"bi start\", \"/bi-start\", \"empezar\", \"comenzar\", \"arranco\".",
+      "category": "command",
+      "triggerCount": 22,
+      "path": "skills/bi-start/SKILL.md"
+    },
     {
       "name": "pbi-connect",
       "title": "Power BI MCP Connection Skill",
-      "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\".",
+      "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\".",
       "category": "command",
-      "triggerCount": 5,
+      "triggerCount": 15,
       "path": "skills/pbi-connect/SKILL.md"
     },
     {
       "name": "project-kickoff",
       "title": "Project Kickoff Skill",
-      "description": "Project Kickoff Skill: Project analysis and planning.",
+      "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\".",
       "category": "command",
-      "triggerCount": 0,
+      "triggerCount": 15,
       "path": "skills/project-kickoff/SKILL.md"
+    },
+    {
+      "name": "report-design",
+      "title": "Report Design Skill",
+      "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\".",
+      "category": "command",
+      "triggerCount": 9,
+      "path": "skills/report-design/SKILL.md"
     }
   ]
 }

package/.plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "spec": "open-plugin-spec@1",
   "name": "bi-superpowers",
-  "version": "3.2.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

@@ -17,6 +17,36 @@
 
 ---
 
+## QA Codex Shortcut
+
+When the user says `qa codex` in a new session for this repo, treat it as activating the external QA review workflow.
+
+Role split:
+- **Codex** — external QA / code reviewer
+- **Claude Code** — primary implementer
+- **Lucas** — bridge between both agents
+
+Default review protocol:
+1. Read `coordination/ACTIVE_PLAN.md` first.
+2. Read `coordination/TO_CODEX_REVIEW.md` second.
+3. If `TO_CODEX_REVIEW.md` references an audit or follow-up review file, read that too.
+4. Review commits or staged diffs with focus on:
+   - functional bugs
+   - regressions
+   - reasonable missing tests
+   - drift between `src/content/...` and generated artifacts
+   - build/release risks
+   - Windows + Power BI Desktop risks
+5. Return prioritized findings first and a short summary second.
+
+Working rules:
+- Codex is a second opinion, not the implementation owner and not a release gate.
+- Do not assume you saw the whole previous session; rely on the coordination `.md` files.
+- If the user asks for a prompt for Claude, provide a copy-paste-ready prompt that explicitly references the coordination files above.
+- This shortcut is a repo convention for future sessions, not implicit model memory.
+
+---
+
 ## 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.
@@ -79,7 +109,7 @@ The repo uses **GitHub Actions** to publish automatically. The `NPM_TOKEN` is st
 
 ---
 
-AI-powered toolkit for Power BI, Fabric & Excel development.
+AI-powered toolkit for Power BI Desktop development across Claude Code, GitHub Copilot, Codex, Gemini CLI, and Kilo Code.
 
 Developed by **Lucas Sanchez** ([@luquimbo](https://github.com/luquimbo))
 
@@ -87,27 +117,28 @@ Developed by **Lucas Sanchez** ([@luquimbo](https://github.com/luquimbo))
 
 ## Installation
 
-### Claude Code (primary — full experience)
+### Supported Coding Agents
 
 ```bash
 # 1. Install the CLI globally
 npm install -g @luquimbo/bi-superpowers
 
-# 2. Initialize the plugin in your project
-cd your-bi-project
-super kickoff
-
-# 3. Run Claude Code with the plugin
-claude --plugin-dir .
+# 2. Install skills + MCPs for your coding agents
+super install
 ```
 
-You get:
-- **24 skills** — activated automatically by keyword
-- **11 slash commands** — `/project-kickoff`, `/dax-doctor`, `/data-model-design`, etc.
-- **4 Microsoft MCP servers** — Power BI, Fabric, Modeling, Microsoft Learn
-- **Biblioteca completa** — snippets, templates, themes de Power BI
+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`
 
-Open source (MIT). Sin licencias ni keys.
+Agent-specific behavior:
+- **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**. `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
 
@@ -116,23 +147,7 @@ super build-desktop
 # Double-click bi-superpowers.mcpb para instalar en Claude Desktop
 ```
 
-Los 24 skills quedan disponibles como MCP prompts.
-
-### Other AI agents (experimental — skills only)
-
-Los 24 skills funcionan en **GitHub Copilot, Codex, Gemini CLI, Kilo Code** vía el estándar abierto Agent Skills, pero con limitaciones:
-
-- Los slash commands (`/dax-doctor`, etc.) **solo funcionan en Claude Code**. En otros agentes hay que usar lenguaje natural.
-- Los MCP servers **solo funcionan en agentes con soporte MCP** (Claude Code, Copilot en VS Code, Codex).
-- La configuración automática de MCPs Microsoft (Power BI Desktop local, Fabric auth) **solo está automatizada en el flujo de Claude Code**.
-
-Si igual querés los skills en otro agente:
-
-```bash
-npx @luquimbo/bi-superpowers install
-```
-
-Instala los 24 skills en `~/.agents/skills/` con symlinks a los directorios específicos de cada agente. Este comando es un bonus para usuarios avanzados; la experiencia full sigue siendo Claude Code.
+Los 4 skills quedan disponibles como MCP prompts.
 
 ---
 
@@ -160,18 +175,20 @@ Instala los 24 skills en `~/.agents/skills/` con symlinks a los directorios espe
 - **No Laziness**: Fix root causes, avoid temporary patches.
 - **Minimal Impact**: Touch only what is necessary.
 
-## Available Skills (2)
+## 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 bundled Node scripts | "report design", "crear reportes" |
 
 ## MCP Servers (2)
 
 | MCP | Type | Purpose |
 |-----|------|---------|
-| `powerbi-modeling` | stdio | Local connection to Power BI Desktop via XMLA |
+| `powerbi-modeling-mcp` | stdio | Local connection to Power BI Desktop via XMLA |
 | `microsoft-learn` | http | Microsoft Learn docs in context |
 
 ---
@@ -192,9 +209,9 @@ BI Agent Superpowers generates a native Claude Code plugin from a single source
 ```
 project/
 ├── .claude-plugin/plugin.json   # Plugin manifest
-├── .mcp.json                    # Power BI + Fabric MCPs
-├── commands/*.md                # 11 slash commands (interactive wizards)
-├── skills/*/SKILL.md            # 24 skills (all discoverable)
+├── .mcp.json                    # Power BI Modeling + Microsoft Learn MCPs
+├── 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

@@ -5,6 +5,316 @@ All notable changes to BI Agent Superpowers will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [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
+  arrange around. Shows an informative menu of the 4 skills, runs the update
+  check, and — on Windows when a `.pbip` project is detected — offers to
+  connect to Power BI Desktop via MCP in one step. Designed to replace the
+  "but wait, which command do I type?" moment at the start of a session.
+  `/project-kickoff` is now reserved for brand-new BI project bootstraps.
+- **Three-level auto-update architecture** (closes ROADMAP item 4):
+  - _Level 1 (CLI banner)_: `update-notifier@^5.1.0` wrapped in `bin/cli.js`
+    — every `super <cmd>` spawns a detached background check against the
+    npm registry (24h cache) and prints a yellow update banner at process
+    exit when a newer version is on npm.
+  - _Level 2 (cross-agent skill preamble)_: `bin/commands/update-check.js`
+    is a standalone Node helper with 24h cache + escalating snooze
+    (24h → 48h → 7d) + network fallback. The Claude Code plugin generator
+    prepends an "update check" preamble to every `SKILL.md` and
+    `commands/*.md` that instructs the agent to run the helper at the top
+    of each conversation and — at most once per conversation — surface a
+    one-line "hay bi-superpowers vX disponible" notice. Works regardless
+    of the agent (Claude Code, Copilot, Codex, Gemini CLI, Kilo).
+  - _Level 3 (Claude Code native)_: `/plugin update bi-superpowers` via
+    the Claude Code marketplace, documented in `README.md`. Zero-npm UX
+    for users who installed via the marketplace.
+- **`.gitattributes`** normalizing text files to LF — fixes
+  `npm run format:check` on Windows working trees (the CRLF-via-autocrlf
+  vs. Prettier `endOfLine: "lf"` mismatch that quietly broke `prepack`
+  for Windows developers).
+- **`apply-theme.js` test coverage** — 13 new tests across happy path,
+  idempotent replacement, error paths, and atomic write/backup behavior.
+  Was previously the most dangerous script with zero tests.
+- **`update-check.js` test coverage** — 30 tests across `compareVersions`,
+  cache freshness, snooze state + escalation, filesystem persistence,
+  and end-to-end CLI behavior via `spawnSync` (no real network calls).
+- **Plugin manifest enrichment** (`.claude-plugin/plugin.json`) — now
+  inherits `repository`, `homepage`, `license`, and `keywords` from
+  `package.json` so Claude Code plugin marketplace listings match the
+  npm package metadata.
+- **Desktop extension build includes folder-based skills** — the `.mcpb`
+  extension produced by `super build-desktop` was silently dropping
+  `report-design` (the flagship skill) because the bundler only picked
+  up flat `.md` files. Now uses `loadSkills()` which handles both flat
+  and folder-based layouts. 5 regression tests.
+- **Skill trigger parser extracts multiple quoted fragments per bullet** —
+  `project-kickoff` went from `triggerCount: 0` to `9` in
+  `.claude-plugin/skill-manifest.json`; `pbi-connect` from `5` to `15`;
+  `report-design` from `3` to `9`.
+- **`validate-pbir.js` detects duplicate `visual.name` on the same page** —
+  PBI Desktop accepts the file, but filter/bookmark refs collide.
+- **README rewrite**: dual install paths clearly segmented by audience
+  (Claude Code users → marketplace, everyone else → npm + `super install`),
+  mirrored update instructions, and OQ-1 resolution explained inline.
+- **Opus 4.7 1M code review report** at
+  `coordination/CODE_REVIEW_OPUS_2026-04-21.md` — 3 blockers + 5 high +
+  8 medium + 7 low findings across the whole repo (all resolved in this
+  release, except 4 mediums/3 lows explicitly deferred as product calls).
+
+### Changed
+
+- **`/project-kickoff` triggers narrowed to "new project" intent** —
+  "empezar", "arranco", "get started", "comenzar", "qué tengo aquí"
+  previously all landed on `/project-kickoff`. They now route to
+  `/bi-start`. `/project-kickoff` keeps "nuevo proyecto", "analizar
+  proyecto", "bootstrap BI", "armar el modelo base", etc.
+- **Galería de Visuales regenerated via `create-visual.js` end-to-end**
+  (ROADMAP item 2) — the 22 visuals on the theme page in
+  `examples/smoke-test/` are now produced by the script, not
+  hand-written. Both validators green (`pbi report validate` +
+  `node validate-pbir.js`).
+- **`super upgrade`** prints a formatted "next steps" block after the
+  reinstall with both update paths. Also resets
+  `~/.bi-superpowers/update-state.json` on success so the new version
+  starts clean.
+- **SKILL.md PHASE 4.2 contradictions fixed** — the cheatsheet no longer
+  recommends `lineStackedColumnComboChart` (blocked by `create-visual.js`
+  because Desktop renders it as an empty container), and the stale
+  "write visual.json with the raw typeId" fallback paragraph that
+  contradicted MANDATORY RULE 2 is gone.
+- **Stale `pbi-cli-tool` references removed** from 5 user-facing surfaces
+  (`bin/postinstall.js`, `bin/commands/install.js`,
+  `bin/lib/generators/shared.js`, `desktop-extension/manifest.json`,
+  `README.md`). The skill now says "Power BI Desktop (Windows)" —
+  `pbi-cli-tool` is optional for model introspection only.
+- **Tarball trimmed** — `files` whitelist now excludes `**/*.test.js`.
+  Package size: 175.8 kB → 152.4 kB (103 → 88 files).
+- **`desktop-extension/manifest.json` platforms narrowed to `["win32"]`** —
+  the extension was declaring `darwin + linux` compatibility but its
+  flagship skill stops on non-Windows. Non-Windows users get the full
+  skill set via `npm install -g && super install` instead.
+- **Visual-type count drift fixed** — the allowlist actually has 28 native
+  types, not 25/26/27 as variously documented across `create-visual.js`,
+  `create-visual.test.js`, and `SKILL.md` (4 places). All now say 28.
+- **`getSkillPurpose` map pruned** — 19 dead entries for skills that never
+  existed in v4 (dax, power-query, dax-doctor, governance, etc.) were
+  removed. Parity test added so the map stays in sync with
+  `src/content/skills/` automatically.
+
+### Fixed
+
+- **`escapePbiLiteral` now collapses newlines/tabs to single spaces** —
+  a `--title` containing a newline produced a malformed PBI literal.
+- **`apply-theme.js --name` rejects path separators** — previously accepted
+  `--name "../../evil.json"` which would write outside
+  `StaticResources/RegisteredResources/`. Local-only issue, but still
+  defense-in-depth.
+- **Textbox no longer double-renders `--title`** — `--title` for a textbox
+  is a paragraph shortcut, but the generator was also applying it as the
+  container title, so Desktop rendered the title twice (inner paragraph +
+  container chrome). Now the textbox container is always chrome-less
+  regardless of `--title`.
+- **Textbox omits `drillFilterOtherVisuals`** — textboxes have no query;
+  the flag was meaningless noise in the generated `visual.json`.
+
+### Removed
+
+- **19 dead `getSkillPurpose` entries** for never-shipped skills
+  (`dax`, `power-query`, `data-modeling`, `data-model-design`,
+  `excel-formulas`, `theme-tweaker`, `rls-design`, `query-performance`,
+  `data-quality`, `fast-standard`, `testing-validation`, `contributions`,
+  `dax-doctor`, `model-documenter`, `migration-assistant`, `report-layout`,
+  `governance`, `semantic-model`, `deployment`, `dax-udf`). Map is now
+  parity-tested against the actual `src/content/skills/` tree.
+
+### Test count
+
+- 227 → **301** (+74 tests across 80 suites).
+
+### Migration
+
+Upgrading from v4.0.x is backwards-compatible at the user level — no config
+changes required. Recommended sequence:
+
+```bash
+# Users on Claude Code marketplace:
+/plugin update bi-superpowers
+
+# Users on npm:
+super upgrade
+super install --yes    # propagate the new skills to all agents
+```
+
+Session-opener users: when you previously said "empezar" / "arranco" /
+"get started", you now land in `/bi-start` (menu + update + connect),
+which will route you to `/project-kickoff` if you actually mean to
+bootstrap a new project.
+
+---
+
+## [4.0.0] — 2026-04-15
+
+### Breaking — `/report-design` pivoted to CLI-first architecture
+
+The `/report-design` skill has been rewritten to orchestrate the
+[`pbi-cli-tool`](https://github.com/MinaSaad1/pbi-cli) CLI (MIT,
+by MinaSaad1) instead of hand-writing PBIR JSON. This is a **breaking
+change** because students now need Python 3.10+ and `pbi-cli-tool`
+installed (the skill auto-guides installation in PHASE 0).
+
+**Why the pivot.** Smoke testing proved that Power BI Desktop does
+NOT render externally-written `visual.json` files while the app is
+running. The only reliable pattern is: close Desktop → write via CLI
+→ reopen Desktop fresh. This "close-write-open" pattern is now the
+backbone of the skill. The `pbi-cli-tool` CLI handles all PBIR
+JSON generation (schema versioning, binding syntax, visual types) —
+removing our most fragile maintenance burden.
+
+### Added
+
+- `close-write-open-pattern.md` — documents the core insight:
+  PBI Desktop caches the report in memory and ignores external disk
+  changes. Visuals must be added while Desktop is killed, then Desktop
+  relaunched to do a fresh disk scan.
+- `cli-setup.md` — step-by-step Python + pipx + pbi-cli-tool install
+- `cli-commands.md` — cheatsheet of `pbi` commands used by the skill
+- `ensure-pbi-cli.sh` — idempotent install helper script
+- PHASE 3 in SKILL.md now explicitly kills `PBIDesktop.exe` (with
+  user confirmation) before generating visuals
+- PHASE 5 relaunches Desktop via `Start-Process` for fresh scan
+- `examples/smoke-test/` — live test project with model + CLI-generated
+  visuals (excluded from npm via `files` whitelist)
+- `research/` folder (gitignored) for third-party reference repos
+
+### Removed
+
+- `references/primitives/*.md` (6 files) — hand-written visual JSON
+  templates, replaced by CLI generation
+- `references/bootstrap-card.md` — bootstrap pattern, CLI handles this
+- `references/file-templates.md` — PBIR file structure, CLI handles this
+- `references/fluent-palette.md` — theme colors, Desktop applies Fluent
+- `references/known-uncertainties.md` — schema uncertainty, CLI handles
+- `scripts/validate-pbir.js` — replaced by `pbi report validate`
+
+### Changed
+
+- SKILL.md completely rewritten around CLI workflow (~200 lines,
+  down from ~400)
+- Layout files updated to use CLI visual type names (`card`,
+  `line_chart`, `bar_chart`, `matrix`, `table`)
+- `project-kickoff.md` PHASE 7 handoff updated to mention CLI prereq
+- `base.md` and `routing.md` descriptions updated
+- `troubleshooting.md` rewritten for CLI-specific errors
+- `report-design` added to `COMMAND_SKILLS` in the generator (now a
+  slash command, not just a reference skill)
+
+### Credits
+
+- [`pbi-cli-tool`](https://github.com/MinaSaad1/pbi-cli) by MinaSaad1
+  (MIT License) — the execution layer for PBIR report generation
+- [`power-bi-agentic-development`](https://github.com/data-goblin/power-bi-agentic-development)
+  by Kurt Buhler (GPL-3.0) — studied as reference for workflow patterns
+  and PBIR mental model; no code incorporated
+
+---
+
+## [3.4.0] — 2026-04-15
+
+### Added
+
+- **New skill: `/report-design`.** Authors 3 PBIR report pages directly
+  from a ready semantic model. Produces Pro-quality visuals — conditional
+  formatting, KPI cards with trend coloring, matrix with gradients,
+  slicers, sorted bar charts, pixel-perfect 1280×720 grid layout.
+  Adapts layout to domain (finance / sales / hr / operations / marketing /
+  otro).
+- **Folder-based skill support.** The skill loader and plugin generator
+  now accept skills authored as a folder with `SKILL.md` + `references/`
+  + `scripts/` subfolders (Anthropic's skill convention). Used by
+  `/report-design` — the main SKILL.md is a thin orchestrator and the
+  agent loads PBIR templates, layouts, and troubleshooting notes on
+  demand from `references/`. Ships a `validate-pbir.js` helper under
+  `scripts/` that structurally validates a generated `.Report/` folder.
+- `/project-kickoff` now ends with a handoff to `/report-design` once
+  the model base has 1 fact + 1 dim + 3 measures.
+
+### Changed
+
+- `base.md` and `routing.md` updated to reflect the 3-skill catalog.
+- The `description` field in `package.json` now reads "3 skills".
+
+### Notes — PBIR Preview risk
+
+PBIR (Power BI Enhanced Report format) is a Microsoft Public Preview
+feature at the time of this release. Students must activate
+**File → Options → Preview features → Power BI Project (.pbip) save
+format (PBIR)** in Power BI Desktop before `/report-design` can write
+report files. If Microsoft ships a schema update that breaks our
+templates, run `super upgrade` — we commit to keeping the plugin in
+sync with PBIR changes while the feature is in preview.
+
+The skill is intentionally conservative: it reads existing PBIR files
+from the project first to learn the local schema version, and mirrors
+those patterns in everything it writes. If any primitive doesn't render,
+`references/troubleshooting.md` has concrete remedies.
+
+---
+
+## [3.3.0] — 2026-04-14
+
+### Changed
+
+- **Dropped Fabric MCP and Remote Power BI MCP references everywhere.** The
+  plugin now documents only the 2 MCPs it actually ships: `powerbi-modeling-mcp`
+  (local, Windows) and `microsoft-learn` (HTTP, any platform). The `pbi-connect`
+  skill, `project-kickoff` skill, `base.md`, `routing.md`, `mcp-setup` command,
+  and `mcp-requirements.json` were all updated to match.
+- **Fixed naming inconsistency.** `bin/lib/mcp-config.js` now writes
+  `powerbi-modeling-mcp` (the canonical Microsoft name) across all 5 agents,
+  aligned with `.mcp.json` and `bin/lib/microsoft-mcp.js`. Previously it wrote
+  `powerbi-modeling` (short form), which caused a naming mismatch for users
+  who ran both `super install` and the plugin-first flow.
+- **Narrowed `routing.md` and `base.md`** to the 2-skill reality (was still
+  listing 24 skills from v2 architecture).
+
+### Added
+
+- Tests for `bin/lib/generators/shared.js` (`parseSkillMetadata`,
+  `getSkillPurpose`, `generateSkillsSection`, header/footer) — 23 new tests.
+- Tests for `bin/build-plugin.js` `verifyPluginOutputs` — covers the prepack
+  safety net.
+- `.nvmrc` pinning Node 22 for contributors.
+
+### Notes
+
+- Users upgrading from 3.2.x should re-run `super install` so the new
+  canonical server name (`powerbi-modeling-mcp`) lands in their agent
+  configs. The old entry will linger as dead config until cleaned manually;
+  accepted as soft-launch tech debt.
+- Scorecards, Power BI Goals, and Dataflows Gen 2 creation are **not**
+  supported by the official Microsoft MCPs as of 2026-01. Those flows need
+  the Power BI REST API or Fabric REST API directly — outside the MCP scope.
+
+---
+
 ## [3.0.0] — 2026-04-11
 
 ### BREAKING CHANGES — massive scope reduction