pbiplint 0.1.0

package/NOTICE

@@ -0,0 +1,29 @@
+pbiplint itself is licensed under the GNU Affero General Public License,
+version 3 or later; see LICENSE. The MIT license text below applies only
+to the third-party material described here, not to pbiplint.
+
+pbiplint bundles rule definitions derived from BPARules.json in the
+microsoft/Analysis-Services repository (https://github.com/microsoft/Analysis-Services),
+which is licensed under the MIT License:
+
+MIT License
+
+Copyright (c) Microsoft Corporation. All rights reserved.
+
+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.

package/README.md

@@ -0,0 +1,57 @@
+# pbiplint
+
+Best-practice linter for Power BI semantic models. Point it at a `.SemanticModel` folder, a PBIP
+folder, or one `.tmdl` file and get ranked findings with a link to a fix page for each rule.
+Nothing is uploaded: it reads the files you name and writes to your terminal. Node 20 or later.
+
+```bash
+npx pbiplint path/to/Model.SemanticModel
+npx pbiplint --sample                                       # a bundled model with planted violations
+npx pbiplint path/to/model --format sarif --output pbiplint.sarif
+npx pbiplint path/to/model --format markdown
+npx pbiplint rules                                          # every rule with status and severity
+```
+
+Formats: `text` (default), `json`, `sarif` (for GitHub code scanning and editors), `markdown`.
+
+Exit codes: `0` no findings at or above `--fail-on` (default `error`), `1` findings, `2` usage or
+input error. `--fail-on warning` tightens the gate; `--fail-on none` always exits 0.
+
+## Configuration
+
+`pbiplint.config.json` next to the project, or anywhere above it (the nearest one wins; `--config`
+picks one explicitly):
+
+```json
+{
+  "$schema": "https://pbiplint.com/schema/pbiplint.config.schema.json",
+  "rules": {
+    "REMOVE_ROLES_WITH_NO_MEMBERS": "off",
+    "DAX_COLUMNS_FULLY_QUALIFIED": "warning"
+  },
+  "failOn": "warning"
+}
+```
+
+To ignore a rule on one object, annotate it in TMDL (Power BI Desktop keeps the annotation):
+
+```
+	column 'Product ID'
+		dataType: int64
+		annotation pbiplint.ignore = HIDE_FOREIGN_KEYS, MARK_PRIMARY_KEYS
+```
+
+## What it checks
+
+Every rule from the Microsoft Best Practice Analyzer ruleset, ported literally so the numbers match
+Tabular Editor. Five rules need statistics only a live model has; they are listed but not run. Each
+rule has a page at https://pbiplint.com/rules with what it checks, why, how to fix it, and quirks.
+
+The same linter runs in the browser at https://pbiplint.com. Source, issues, and contributing:
+https://github.com/pbiplint/pbiplint.
+
+## License
+
+Copyright (C) 2026 McKinley Consulting. GNU Affero General Public License, version 3 or later; see
+LICENSE. The vendored Microsoft ruleset is MIT-licensed; see NOTICE. The name pbiplint and its
+logo are trademarks of McKinley Consulting.