@luquimbo/bi-superpowers 1.0.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "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.0.0",
+  "author": {
+    "name": "Lucas Sanchez"
+  }
+}

package/.mcp.json

@@ -0,0 +1,25 @@
+{
+  "powerbi-remote": {
+    "type": "http",
+    "url": "https://api.fabric.microsoft.com/v1/mcp/powerbi"
+  },
+  "fabric-mcp-server": {
+    "type": "stdio",
+    "command": "npx",
+    "args": [
+      "-y",
+      "@microsoft/fabric-mcp@latest",
+      "server",
+      "start",
+      "--mode",
+      "all"
+    ]
+  },
+  "powerbi-modeling-mcp": {
+    "type": "stdio",
+    "command": "node",
+    "args": [
+      "${CLAUDE_PLUGIN_ROOT}/bin/mcp/powerbi-modeling-launcher.js"
+    ]
+  }
+}

package/AGENTS.md

@@ -0,0 +1,244 @@
+# BI Agent Superpowers
+
+> **This file OVERRIDES the Universal Agent Base.**  
+> **Base**: `../.claude/CLAUDE.md`  
+> **Read order**: Base → This override → Project Entry Points
+
+## Project Overrides
+- Primary interface is the `super` CLI and the slash-command skills listed below.
+- Adapters generate tool-specific configs; treat adapters as derived artifacts.
+- No lessons/tasks files are required unless the user requests them.
+- AI-generated code must include beginner-friendly comments and remain optimal for agent comprehension.
+
+## Project Entry Points
+- `AGENTS.md` (this file)
+- `library/`
+- `config.json`
+
+AI-powered toolkit for Power BI, Fabric & Excel development.
+
+Developed by **Lucas Sanchez** ([@luquimbo](https://github.com/luquimbo))
+
+---
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g @luquimbo/bi-superpowers
+
+# Activate your license
+super unlock
+
+# Initialize in your project
+super kickoff
+```
+
+The `bi-superpowers kickoff` command generates the Claude Code plugin in your project.
+
+Works with:
+- **Claude Code** — Native plugin (skills + commands + MCP)
+- **1code.dev** — Uses Claude Code SDK (full plugin support)
+- **Claude Desktop** — Via MCPB extension (`super build-desktop`)
+
+---
+
+## Workflow Orchestration
+
+1. **Plan Mode (when allowed)**: For non-trivial work (3+ steps or architectural decisions), use plan mode when the environment supports it or the user asks. Re-plan if context changes.
+2. **Subagents (when available)**: Use subagents only if the environment provides them. Delegate research/exploration in parallel, one task per subagent.
+3. **Self-Improvement Loop (context-aware)**: Capture corrections only if the repo uses a lessons file or the user asks. Keep rules concise. Review lessons only when such a file exists.
+4. **Verification Before Done**: Do not mark complete without proof. Run tests/checks when available, document limitations if you cannot.
+5. **Demand Elegance (balanced)**: For non-trivial changes, prefer the elegant solution; avoid hacky fixes.
+6. **Autonomous Bug Fixing**: For bug reports, own the fix end-to-end using logs/tests as evidence.
+
+## Task Management
+
+1. **Plan First**: Write a plan to a task file only if the repo uses one or the user requests it.
+2. **Verify Plan**: Check in before implementation when appropriate.
+3. **Track Progress**: Mark items complete if tracking is in use.
+4. **Explain Changes**: Provide high-level summaries at each step.
+5. **Document Results**: Add a review section when task tracking is in scope.
+6. **Capture Lessons**: Update lessons only when the repo uses it or the user requests it.
+
+## Core Principles
+
+- **Simplicity First**: Minimal, clear changes.
+- **No Laziness**: Fix root causes, avoid temporary patches.
+- **Minimal Impact**: Touch only what is necessary.
+
+## Available Skills (24)
+
+### Command Skills (11 Interactive Wizards)
+
+| Skill | Purpose | Trigger |
+|-------|---------|---------|
+| `/project-kickoff` | Analyze and plan BI projects | "analyze project", "new project" |
+| `/data-model-design` | Interactive star schema builder | "design model", "data model" |
+| `/theme-tweaker` | Customize Power BI themes | "customize theme", "colors" |
+| `/pbi-connect` | Connect to Power BI Desktop | "connect Power BI", "MCP" |
+| `/rls-design` | Row-level security design | "RLS", "security" |
+| `/fabric-scripts` | Microsoft Fabric automation | "Fabric", "scripts", "automation" |
+| `/contributions` | Contribution guidelines | "contribute", "PR guidelines" |
+| `/dax-doctor` | DAX debugging and optimization | "debug DAX", "fix measure", "DAX error" |
+| `/model-documenter` | Semantic model documentation | "document model", "data dictionary" |
+| `/migration-assistant` | Migration and upgrade wizard | "migrate", "convert to PBIP", "move to Fabric" |
+| `/report-layout` | Report page layout planner | "report layout", "page design" |
+
+### Reference Skills (13 Background Knowledge)
+
+| Skill | Purpose | Trigger |
+|-------|---------|---------|
+| `/dax` | DAX writing assistance | "DAX", "measure", "calculated column" |
+| `/power-query` | Power Query / M language | "Power Query", "M code" |
+| `/data-modeling` | Star schema theory and patterns | "star schema", "modeling best practices" |
+| `/excel-formulas` | Modern Excel formulas | "Excel formula", "XLOOKUP" |
+| `/fast-standard` | FP&A Financial modeling (FAST) | "FAST standard", "financial model" |
+| `/query-performance` | Performance optimization | "optimize", "slow", "performance" |
+| `/data-quality` | Data profiling and validation | "data quality", "validation" |
+| `/testing-validation` | DAX and data testing workflows | "testing", "test cases" |
+| `/governance` | Naming conventions and standards | "naming convention", "governance" |
+| `/semantic-model` | Semantic model best practices | "semantic model", "TMDL", "DirectLake" |
+| `/report-design` | Report design and visualization | "chart type", "IBCS", "accessibility" |
+| `/deployment` | CI/CD and deployment patterns | "CI/CD", "pipeline", "DevOps" |
+| `/dax-udf` | DAX user-defined functions (UDFs) | "UDF", "DEFINE FUNCTION", "DAX Lib" |
+
+---
+
+## Plugin System
+
+BI Agent Superpowers generates a native Claude Code plugin from a single source of truth.
+
+### Output Targets
+
+| Target | Format | Output |
+|--------|--------|--------|
+| Claude Code / 1code.dev | Plugin | `.claude-plugin/`, `commands/`, `skills/`, `.mcp.json` |
+| Claude Desktop | MCPB extension | `bi-superpowers.mcpb` (via `super build-desktop`) |
+
+### Plugin Structure (generated by kickoff/recharge)
+
+```
+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)
+├── config.json                  # User preferences
+└── library/ → symlink           # Snippets, templates, themes
+```
+
+### Desktop Extension (generated by build-desktop)
+
+```
+desktop-extension/
+├── manifest.json     # MCPB v0.3 manifest
+├── server.js         # MCP server exposing skills as prompts
+├── package.json      # Dependencies
+└── skills/           # Bundled at build time
+```
+
+Run `bi-superpowers recharge` after modifying skills to regenerate the plugin.
+
+---
+
+## Library Resources
+
+The `library/` folder contains reusable assets:
+
+```
+library/
+├── snippets/           # Code patterns
+│   ├── dax/            # Time intelligence, rankings, CALCULATE
+│   ├── power-query/    # Transformations, error handling
+│   ├── excel-formulas/ # Dynamic arrays, lookups
+│   ├── report-design/  # Chart selection, accessibility, layouts
+│   └── governance/     # Naming conventions, review checklists
+├── templates/          # Project templates
+│   ├── power-bi/
+│   ├── excel/
+│   └── data-models/
+├── themes/             # Visual themes
+│   └── power-bi/       # JSON theme files
+└── examples/           # Reference implementations
+    ├── finance-reporting/
+    ├── hr-analytics/
+    ├── retail-analytics/
+    ├── supply-chain/
+    └── marketing-analytics/
+```
+
+Reference patterns in prompts:
+```
+"Using patterns from library/snippets/dax/time-intelligence.md,
+create a rolling 12-month average measure"
+```
+
+---
+
+## Configuration
+
+Project-local user preferences live in `config.json`:
+
+- This file is meant to be read by your AI tool as **context** (experience level, language, domain terms).
+- `bi-superpowers kickoff` will create it automatically from the package template if it doesn't exist.
+- The CLI stores selected AI tools in `.bi-superpowers.json` (also project-local) so `bi-superpowers recharge` knows what to regenerate.
+
+```json
+{
+  "experienceLevel": "intermediate",  // beginner | intermediate | advanced
+  "language": "en",
+  "workArea": "finance",
+  "powerBIConnection": "desktop"      // desktop | fabric | pbip
+}
+```
+
+---
+
+## Detailed Documentation
+
+For comprehensive AI context and behavior guidelines, see:
+- `src/content/base.md` - Core AI identity and guidelines
+- `src/content/skills/*.md` - Individual skill definitions
+- `src/content/routing.md` - Skill activation logic
+
+---
+
+## Project Types
+
+| Type | Format | Best For |
+|------|--------|----------|
+| Desktop (.pbix) | Binary | Personal projects, quick prototypes |
+| PBIP | Text (TMDL) | Team projects, CI/CD, code reviews |
+| Fabric | Cloud | Enterprise, shared models, real-time collaboration |
+
+---
+
+## MCP Integration
+
+Connect AI assistants directly to Power BI and Excel:
+
+**Power BI MCP** (via VS Code extension):
+- Read/write measures and relationships
+- Execute DAX queries
+- Modify model structure
+
+**Excel MCP**:
+- Read/write cells and ranges
+- Manage worksheets and tables
+- Apply formatting
+
+---
+
+## Resources
+
+| Resource | URL |
+|----------|-----|
+| GitHub | https://github.com/luquimbo/bi-superpowers |
+| MCP Protocol | https://modelcontextprotocol.io |
+| Power BI Docs | https://docs.microsoft.com/power-bi |
+| DAX Guide | https://dax.guide |
+
+---
+
+**BI Agent Superpowers** - Developed by Lucas Sanchez ([@luquimbo](https://github.com/luquimbo))

package/CHANGELOG.md

@@ -0,0 +1,265 @@
+# Changelog
+
+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).
+
+## [Unreleased]
+
+### Added
+- Native Claude Code plugin structure at the project root:
+  - `.claude-plugin/plugin.json`
+  - `.mcp.json`
+  - `commands/`
+  - `skills/`
+- Root plugin build script: `npm run build:plugin`
+- Official Microsoft Modeling MCP launcher wrapper in `bin/mcp/powerbi-modeling-launcher.js`
+- Central Microsoft MCP configuration module in `bin/lib/microsoft-mcp.js`
+- Plugin build tests and MCP configuration tests
+
+### Changed
+- Product direction is now plugin-first for Claude Code
+- `bi-superpowers kickoff` now initializes the Claude Code plugin by default and only offers legacy adapters as optional compatibility outputs
+- `bi-superpowers recharge` now regenerates the plugin first, then any configured legacy outputs
+- `bi-superpowers mcp-setup` now writes official Microsoft MCP configurations from one shared source of truth
+- `powerbi-remote` now uses the official HTTP endpoint instead of legacy SSE-style config
+- `fabric-mcp-server` now uses Microsoft’s published `@microsoft/fabric-mcp@latest` command
+- Power BI Modeling MCP now launches through the official Microsoft executable instead of `uvx`
+- README, getting started, architecture docs, and source skills now describe the plugin-first workflow
+
+### Deprecated
+- Legacy adapters remain supported for compatibility, but new feature work is focused on the native Claude Code plugin
+- Unofficial Excel MCP setup is no longer part of the main product path
+
+---
+
+## [2.5.0] - 2026-01-30
+
+### Major Architectural Improvements
+
+This release includes significant enhancements to the codebase structure, testing, and AI tool support.
+
+#### Added
+- **Extended AI Tool Support**
+  - Added Kilocode adapter with MCP template support
+  - Improved ChatGPT custom instructions generation
+  - Enhanced Cursor rules generation
+
+- **Enhanced CLI Commands**
+  - `bi-superpowers mcp-setup` / `bi-superpowers mcp` - Configure MCP servers for AI tools
+  - Improved `bi-superpowers scan` with `--skill` and `--tool` filtering options
+  - Better `bi-superpowers sentinel` with tool-specific watching
+
+- **Testing Infrastructure**
+  - Added comprehensive test suite for CLI commands
+  - Test files for critical utilities (git.js, tui.js, generators)
+  - Node.js native test runner integration (`npm test`)
+
+- **Code Quality**
+  - ESLint 9 configuration with flat config format
+  - Prettier formatting across all bin/ files
+  - Pre-pack validation script (`npm run check`)
+
+#### Changed
+- **Generator System Refactor**
+  - Moved generators to `bin/lib/generators/`
+  - Shared utilities in `generators/shared.js`
+  - Factory pattern with `generators/index.js`
+
+- **Utility Organization**
+  - Consolidated utilities in `bin/utils/`
+  - Improved error handling patterns
+  - Better logging with `utils/logger.js`
+
+#### Fixed
+- ESLint 9 compatibility issues
+- Code formatting inconsistencies
+- Generator output path handling
+
+#### Documentation
+- Added npm publishing guide for passkey 2FA users
+- Updated CLI command reference
+
+---
+
+## [2.4.0] - 2026-01-29
+
+### Two-Level Configuration Architecture
+
+Major update introducing workspace and project level configurations with enhanced MCP support.
+
+#### Added
+- **Workspace Configuration** (`bi-workspace.json`)
+  - New versioned config file for bi-repo workspaces
+  - Shared MCP configuration for the entire team
+  - GitHub and Fabric MCP support at workspace level
+  - Changelog settings for all projects
+
+- **Project Configuration** (`bi-project.json`)
+  - New versioned config file for individual projects
+  - Project-specific MCP settings (Power BI port, Fabric workspace ID)
+  - Changelog configuration per project
+  - Agent context customization
+
+- **Changelog System**
+  - New `bi-superpowers changelog` command to generate changelog from Git history
+  - Automatic categorization of commits (Added, Changed, Fixed, etc.)
+  - Integration with agent context (Recent Changes section in CLAUDE.md)
+  - Configurable number of recent changes to include
+
+- **Enhanced MCP Setup**
+  - `--github user/repo` flag for GitHub MCP configuration
+  - `--fabric [workspaceId]` flag for Fabric remote MCP
+  - Support for both workspace and project level MCP configs
+
+#### Changed
+- **super setup** now includes MCP configuration wizard
+- **super add** creates `bi-project.json` and initial `CHANGELOG.md`
+- Separated local config (`.bi-superpowers.json`) from versioned config
+- MCP configs generated for Claude Code, Cursor, and VS Code
+
+#### Technical
+- Added `execGitCommand` and `getFileLastModified` to git utilities
+- New `changelog.js` command module
+- Extended `mcp-setup.js` with GitHub and Fabric support
+
+---
+
+## [2.1.0] - 2026-01-20
+
+### Single Source of Truth Architecture
+
+Major restructuring to support multiple AI tools from a single skill definition.
+
+#### Added
+- **Multi-AI Tool Support** - Skills now work with Claude Code, VS Code, and Open Code (any AI assistant)
+- **Adapter System** - Automatic generation of tool-specific configurations from `src/content/`
+- **super recharge** command - Regenerate all AI tool configs after skill updates
+- **Symlink Support** - `.bi-superpowers` symlink for easy access to library
+
+#### Changed
+- **Reorganized Structure**
+  - Skills moved from `agents/skills/*/SKILL.md` to `src/content/skills/*.md`
+  - Snippets moved from `agents/snippets/` to `library/snippets/`
+  - Templates moved from `agents/templates/` to `library/templates/`
+  - Themes moved from `agents/styles/` to `library/themes/`
+- **CLI Updates**
+  - `bi-superpowers kickoff` now prompts for AI tool selection
+  - Removed `bi-superpowers setup` (replaced by `bi-superpowers kickoff`)
+  - Added interactive menu for tool configuration
+- **Configuration**
+  - Project-specific config now saved as `.bi-superpowers.json` (created by `bi-superpowers kickoff` in each project)
+  - Package template config remains as `config.json` and `config.example.json`
+  - Config now tracks selected AI tools for sync
+
+#### Documentation
+- Updated all documentation to reflect new paths
+- Added architecture diagrams for Single Source of Truth
+- Improved JSDoc comments in CLI code
+
+---
+
+## [2.0.0] - 2026-01-20
+
+### Initial Public Release
+
+This is the first public release of BI Agent Superpowers - an AI-powered toolkit for Power BI, Fabric & Excel development.
+
+**Developed by Lucas Sanchez ([@luquimbo](https://github.com/luquimbo))**
+
+### Features
+
+#### Interactive Skills
+- **Project Kickoff** - Guided BI project planning wizard
+- **Data Model Design** - Star schema builder with best practices
+- **Theme Tweaker** - Power BI theme customization assistant
+- **PBI Connect** - Auto-detect Power BI Desktop for MCP connection
+- **RLS Design** - Row-Level Security implementation wizard
+- **Testing & Validation** - DAX and data testing workflows
+- **Query Performance** - DAX and model optimization
+- **Data Quality** - Data profiling and validation
+- **Fabric Scripts** - Fabric automation script guidance
+- **FAST Standard** - Excel financial modeling standards
+
+#### DAX Snippets
+- Time intelligence (YTD, QTD, MTD, rolling periods)
+- CALCULATE patterns and filter context
+- Ranking and TopN patterns
+- Iterator functions (SUMX, AVERAGEX, etc.)
+- KPI and conditional formatting
+- Error handling patterns
+- Security patterns (RLS/OLS)
+- User-defined functions
+
+#### Power Query Templates
+- Data cleaning and transformation
+- Connection templates (SQL, SharePoint, API, Azure)
+- Parameter patterns and environment configuration
+- Error handling patterns
+- Performance optimization
+
+#### Excel Formulas
+- Dynamic arrays (FILTER, SORT, UNIQUE, SORTBY)
+- Lookup patterns (XLOOKUP, INDEX/MATCH)
+- LET and LAMBDA patterns
+- Aggregation functions
+- Date and time calculations
+
+#### Power BI Themes
+- `bi-superpowers-default.json` - IBCS-inspired default
+- `corporate-blue.json` - Professional corporate
+- `dark-mode.json` - Dark theme
+- `accessible.json` - High contrast accessibility
+- `minimal.json` - Clean minimalist
+- `print-friendly.json` - Optimized for print
+
+#### Data Model Templates
+- Retail Star Schema
+- Finance Model
+
+#### MCP Integration
+- Power BI Desktop connection support
+- Excel MCP Server support
+- PBIP (Power BI Project) file support
+- Fabric workspace connection
+
+### Documentation
+- Comprehensive README with project type guides
+- AGENTS.md with MCP setup instructions
+- ARCHITECTURE.md for system design
+- SECURITY.md for best practices
+- CONTRIBUTING.md for community guidelines
+- GETTING-STARTED.md quick start guide
+
+---
+
+## Version History
+
+| Version | Date | Highlights |
+|---------|------|------------|
+| 2.5.0 | 2026-01-30 | Major architectural improvements, extended AI tool support, testing infrastructure |
+| 2.4.0 | 2026-01-29 | Two-level configuration, changelog system, enhanced MCP setup |
+| 2.1.0 | 2026-01-20 | Single Source of Truth architecture, multi-AI tool support |
+| 2.0.0 | 2026-01-20 | Initial public release |
+
+---
+
+## Getting Started
+
+```bash
+# Install globally
+npm install -g @luquimbo/bi-superpowers
+
+# Initialize in your project
+cd your-project
+super kickoff
+```
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for how to submit changes to this project.
+
+When submitting a pull request, please update this CHANGELOG with your changes under the `[Unreleased]` section.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 BI Agent Superpowers contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.