PBIR Tools v0.9.19

Important: This tool works best for targeted, iterative changes to existing reports -- formatting, property adjustments, field binding, theme changes, validation. It's not designed to replace your thinking or design, and it's also constrained by the brittle limitations of Power BI reports, themselves.

Install: uv tool install pbir-cli or pip install pbir-cli (recommended over native installers)

Skills: Get skills from the power-bi-agentic-development marketplace.
For Claude Code: claude plugin add marketplace data-goblin/power-bi-agentic-development

---

New

• Best Practice Analyzer -- pbir bpa run analyzes PBIR reports with built-in and custom JSON rules, CI-friendly failure thresholds, JSON output, optional fixes, and rule suppressions
• BPA rule management -- pbir bpa rules list/ignore/unignore/ignored for listing rules, suppressing noisy findings, and auditing ignored rules across reports
• Default report context -- path-like commands can now use the active report from pbir connect, including relative paths, globs, and . as the active report sentinel
• Active theme colors -- pbir theme colors --used-only now shows colors actively used by report and page formatting, visual expressions, DAX measures, and conditional formatting
• Visual edit dry runs -- pbir visuals position, pbir visuals resize, and pbir visuals bind now support --dry-run so layout and binding changes can be previewed before saving

Bug Fixes

• Newer visualContainer schema declarations now degrade to warning-only fallback instead of blocking validation when bundled schemas are behind Microsoft
• Table names containing dots, such as 0. Measures, now resolve correctly in field references
• Donut chart role metadata now uses the correct canonical measure role while preserving compatibility with legacy role casing
• Filter validation now checks report, page, and visual filter field references against the semantic model
• Validation output now uses more readable target locations while preserving raw locations in JSON output
• UTF-8 BOM-prefixed PBIR JSON files now load consistently across report, page, visual, theme, and packaged resource readers
• Report.new() now fails cleanly and avoids leaving partially created report folders after scaffold write failures
• .platform display-name metadata now uses the current Fabric platformProperties shape and repairs invalid report metadata before saving
• PBIX mutation paths now fail closed: PBIX files remain available for read-only inspection, but editable operations are directed to .Report folders
• Removing visuals now cleans up orphaned visual interactions
• Deleting visualGroup containers is now guarded so grouped visuals are not removed accidentally
• Visual size guidance now runs through BPA, with validate --qa preserving the existing VISUAL_UNDERSIZED compatibility mapping
• Built-in visual role metadata now matches canonical PBIR queryState role names, including current card, slicer, AI/Q&A, RDL, group, and custom visual cases
• Microsoft schema and bundled runtime artifacts were refreshed, including theme schema 2.153