pbi-enterprise-cli 0.1.0.dev0__tar.gz

pbi_enterprise_cli-0.1.0.dev0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mudassir
+
+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.

pbi_enterprise_cli-0.1.0.dev0/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: pbi-enterprise-cli
+Version: 0.1.0.dev0
+Summary: Power BI enterprise CLI — AI-driven model management, governance, PBIR authoring, XMLA, and DAX testing
+Author-email: Mudassir <mir.mudassir1@gmail.com>
+License: MIT AND LicenseRef-Microsoft-AS-Client-Libraries
+Project-URL: Homepage, https://github.com/mudassir09/pbi-enterprise-cli
+Project-URL: Repository, https://github.com/mudassir09/pbi-enterprise-cli
+Project-URL: Bug Tracker, https://github.com/mudassir09/pbi-enterprise-cli/issues
+Project-URL: Changelog, https://github.com/mudassir09/pbi-enterprise-cli/blob/main/CHANGELOG.md
+Keywords: power-bi,cli,dax,tmdl,pbir,powerbi,microsoft,governance
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Office/Business
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1
+Requires-Dist: rich>=13.0
+Requires-Dist: pythonnet>=3.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: PyYAML>=6.0
+Provides-Extra: ai
+Requires-Dist: anthropic>=0.25; extra == "ai"
+Provides-Extra: viz
+Requires-Dist: Pillow>=10.0; extra == "viz"
+Requires-Dist: python-wcag-contrast-ratio>=1.0; extra == "viz"
+Requires-Dist: playwright>=1.44; extra == "viz"
+Provides-Extra: xmla
+Requires-Dist: msal>=1.28; extra == "xmla"
+Provides-Extra: server
+Requires-Dist: fastapi>=0.110; extra == "server"
+Requires-Dist: uvicorn>=0.29; extra == "server"
+Provides-Extra: sources
+Requires-Dist: sqlalchemy>=2.0; extra == "sources"
+Requires-Dist: openpyxl>=3.1; extra == "sources"
+Requires-Dist: httpx>=0.27; extra == "sources"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: ruff>=0.4.0; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Provides-Extra: all
+Requires-Dist: pbi-enterprise-cli[ai,dev,server,sources,viz,xmla]; extra == "all"
+Dynamic: license-file
+
+# pbi-enterprise-cli
+
+**Full-stack Power BI enterprise automation from the command line.**
+
+```bash
+pip install pbi-enterprise-cli
+pbi doctor          # verify setup
+pbi model tables    # list tables in the connected model
+pbi govern check    # run governance rules
+```
+
+## Feature highlights
+
+- **25 command groups** covering every layer of Power BI development
+- **32 visual types** — from cards to decomposition trees
+- **3 backends** — Desktop (TOM via pythonnet), XMLA (Premium/Fabric), Mock (CI)
+- **PBIR GA format** — read and write `.pbip` project files directly
+- **Governance engine** — 5 built-in rules + custom plugin system
+- **REST source profiling** — Bearer/API-key auth, OData pagination, star-schema scaffold
+- **REPL mode** — interactive session with tab completion and persistent history
+- **Custom visual SDK** — scaffold, build, package, import `.pbiviz`
+- **AI measure generation** — Claude API integration (requires `[ai]` extra)
+- **24 AI skills** — install Claude Code skills (`pbi skills install --all`)
+- **547 unit tests** passing on Python 3.10–3.12
+
+## Install options
+
+```bash
+pip install pbi-enterprise-cli             # base
+pip install "pbi-enterprise-cli[ai]"       # + Claude AI
+pip install "pbi-enterprise-cli[xmla]"     # + MSAL auth for XMLA
+pip install "pbi-enterprise-cli[sources]"  # + SQL/Excel/REST profiling
+pip install "pbi-enterprise-cli[all]"      # everything
+```
+
+## Requirements
+
+- Python 3.10+
+- Windows (for Desktop/XMLA backends using .NET AMO)
+- Power BI Desktop (for the `desktop` backend)
+
+## Links
+
+- [GitHub Repository](https://github.com/mudassir09/pbi-enterprise-cli)
+- [Full Documentation](https://github.com/mudassir09/pbi-enterprise-cli#readme)
+- [Changelog](https://github.com/mudassir09/pbi-enterprise-cli/blob/main/CHANGELOG.md)
+- [Security Policy](https://github.com/mudassir09/pbi-enterprise-cli/blob/main/SECURITY.md)

pbi_enterprise_cli-0.1.0.dev0/README.md

@@ -0,0 +1,309 @@
+# pbi-enterprise-cli
+
+> Full-stack Power BI enterprise automation from the command line — semantic model management, report authoring, governance enforcement, DAX testing, REST source profiling, and AI-powered measure generation.
+
+![Python](https://img.shields.io/badge/python-3.10%2B-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+![Tests](https://img.shields.io/badge/tests-547%20passing-brightgreen)
+![Coverage](https://img.shields.io/badge/coverage-65%25%2B-yellowgreen)
+![Version](https://img.shields.io/badge/version-0.1.0--dev-orange)
+
+---
+
+## What it does
+
+`pbi-enterprise-cli` gives you a single `pbi` command that covers every layer of Power BI development — no clicking through the Desktop UI, no manual file editing, no proprietary tooling dependencies.
+
+| Area | Commands |
+|---|---|
+| **Semantic model** | `pbi model` — tables, columns, relationships, lint, lineage |
+| **DAX measures** | `pbi measure` — add, update, delete, AI-generate |
+| **DAX testing** | `pbi dax` — query, validate, YAML unit-test suites |
+| **Source profiling** | `pbi source` — SQL, Excel, CSV, REST APIs → star-schema scaffold |
+| **Report authoring** | `pbi report` — pages, bookmarks (PBIR GA format) |
+| **Visuals** | `pbi visual` — 32 visual types, colour-scale & data-bar formatting |
+| **Layout** | `pbi layout` — shelf-packing auto-layout, named templates |
+| **Themes** | `pbi theme` — generate WCAG-compliant themes from a brand colour |
+| **Filters** | `pbi filter` — relative-date, TopN, basic value filters |
+| **Governance** | `pbi govern` — 5 built-in rules + custom plugin system, auto-fix |
+| **Security (RLS)** | `pbi security` — role add/delete/test |
+| **Partitions** | `pbi partition` — add, refresh, delete |
+| **Deployment** | `pbi deploy` — snapshot, diff, push via XMLA |
+| **TMDL** | `pbi database` — export / import TMDL snapshots |
+| **Docs** | `pbi docs` — markdown/Confluence data dictionary, audit log |
+| **Tracing** | `pbi trace` — query performance tracing and benchmarking |
+| **Connections** | `pbi connections` — list and manage data source connections |
+| **Skills** | `pbi skills` — 24 Power BI AI skill definitions |
+| **Calendar** | `pbi calendar` — generate date/calendar tables |
+| **Culture** | `pbi culture` — locale and culture settings |
+| **Custom Visuals** | `pbi custom-visual` — manage custom visual imports |
+| **REPL** | `pbi repl` — interactive Power BI shell |
+| **Diagnostics** | `pbi doctor` — check pythonnet, optional deps, platform (works on Linux/macOS too) |
+| **Watch mode** | `pbi watch` — re-run governance + DAX tests on file change |
+| **REST API** | `pbi server` — FastAPI server for pipeline integration |
+
+---
+
+## Backends
+
+The same CLI works against three backends — swap with `--backend`:
+
+| Backend | When to use |
+|---|---|
+| `desktop` (default) | Local Power BI Desktop open with a `.pbip` project |
+| `xmla` | Power BI Premium or Microsoft Fabric — no Desktop required |
+| `mock` | CI pipelines, unit tests, demos — zero infrastructure |
+
+---
+
+## Installation
+
+**Base install** (semantic model, governance, DAX, report authoring):
+```bash
+pip install pbi-enterprise-cli
+```
+
+The base install includes **PyYAML**, so YAML-based DAX unit-test suites (`pbi dax test --suite`) work out of the box with no extra packages.
+
+**Optional feature groups:**
+```bash
+pip install "pbi-enterprise-cli[ai]"       # Claude AI measure generation
+pip install "pbi-enterprise-cli[xmla]"     # XMLA auth (MSAL)
+pip install "pbi-enterprise-cli[sources]"  # SQL / Excel / REST profiling
+pip install "pbi-enterprise-cli[viz]"      # WCAG theme validation, screenshots
+pip install "pbi-enterprise-cli[server]"   # FastAPI REST server
+pip install "pbi-enterprise-cli[all]"      # Everything
+```
+
+> **Requirements:** Python 3.10+. The `desktop` and `xmla` backends require Windows and the AMO .NET assemblies (installed with Power BI Desktop).
+
+---
+
+## Quick Start
+
+```bash
+# Check your setup
+pbi doctor
+
+# Connect to open Power BI Desktop and inspect the model
+pbi model tables
+pbi model relationships
+pbi measure list
+
+# Run governance checks
+pbi govern check
+
+# Auto-fix safe violations (PascalCase, missing format strings, etc.)
+pbi govern fix --auto
+
+# Add a measure
+pbi measure add \
+  --table Sales \
+  --name "Total Revenue" \
+  --expression "SUM(Sales[Revenue])" \
+  --format-string "#,0.00" \
+  --description "Net revenue after discounts"
+
+# Run DAX unit tests
+pbi dax test --suite tests/fixtures/measures/sales_suite.yaml
+
+# Profile a REST API and scaffold a star-schema model
+pbi source profile --type rest \
+  --url https://api.example.com/v1/orders \
+  --bearer-token $MY_TOKEN \
+  --output profile.json
+
+pbi source scaffold --profile profile.json
+```
+
+---
+
+## Report Authoring (PBIP / PBIR)
+
+Write directly to the `.pbip` project files — no running Desktop required. Open Desktop after to see the changes.
+
+```bash
+# Pages
+pbi report pages       --pbip ./Sales.Report
+pbi report page-add    --pbip ./Sales.Report --name "Executive Summary"
+
+# Visuals (32 types: card, bar, column, line, table, slicer, matrix, scatter, pie, map, ...)
+pbi visual add --pbip ./Sales.Report \
+  --page "Executive Summary" \
+  --type card \
+  --table Sales --value "Total Revenue" --measure
+
+# Bookmarks
+pbi report bookmark-add --pbip ./Sales.Report --name "Q4 2024 View"
+
+# Conditional formatting
+pbi visual format-color-scale --pbip ./Sales.Report \
+  --page "Executive Summary" \
+  --visual-title "Sales by Product" \
+  --table Sales --field Revenue \
+  --min "#FF6B6B" --mid "#FFD93D" --max "#6BCB77"
+
+# Auto-layout (shelf-packing)
+pbi layout auto --pbip ./Sales.Report --page "Executive Summary"
+```
+
+---
+
+## Governance
+
+Five built-in rules run out of the box. Drop a `.py` file in `~/.pbi-cli/rules/` to add your own:
+
+```python
+# ~/.pbi-cli/rules/no_spaces_in_columns.py
+RULE_ID = "custom.no_spaces_in_columns"
+
+def check(backend):
+    violations = []
+    for table in backend.table_list():
+        for col in backend.column_list(table["name"]):
+            if " " in col["name"]:
+                violations.append({
+                    "rule": RULE_ID,
+                    "object": f"{table['name']}.{col['name']}",
+                    "message": "Column name contains a space.",
+                    "severity": "warning",
+                    "autoFixable": False,
+                })
+    return violations
+```
+
+```bash
+pbi govern rules    # lists all built-in + plugin rules
+pbi govern check    # exit code 1 on errors — use as a CI gate
+pbi govern fix --auto
+```
+
+---
+
+## XMLA Backend
+
+Connect to Power BI Premium or Fabric — no Desktop required:
+
+```python
+from pbi_cli.backends.xmla_backend import XmlaBackend
+
+b = XmlaBackend()
+b.connect(
+    "powerbi://api.powerbi.com/v1.0/myorg/MySalesWorkspace",
+    catalog="MySalesDataset",
+    auth_mode="service_principal",   # or "device_flow" / "token"
+    client_id=..., client_secret=..., tenant_id=...,
+)
+print(b.table_list())
+print(b.dax_query("EVALUATE TOPN(5, Sales)"))
+```
+
+Connection pooling is automatic — same `(endpoint, catalog)` pair reuses the live AMO Server object.
+
+---
+
+## Skills
+
+`pbi-enterprise-cli` ships **24 AI skill definitions** under `skills/` for use with Claude and other AI agents. Each skill encapsulates domain expertise for a specific Power BI area:
+
+| Skill | Purpose |
+|---|---|
+| `power-bi-dax` | Write, optimise, and test DAX expressions |
+| `power-bi-modeling` | Design star schemas, relationships, and calculated columns |
+| `power-bi-visuals` | Choose and configure the right visual for any scenario |
+| `power-bi-report` | Page layout, bookmarks, and report UX patterns |
+| `power-bi-governance` | Apply and enforce governance rules across a dataset |
+| `power-bi-themes` | Generate and validate WCAG-compliant colour themes |
+| `power-bi-sources` | Profile and scaffold data sources into star-schema models |
+| `power-bi-security` | Define and validate RLS roles and row-level security |
+| `power-bi-deployment` | Snapshot, diff, and deploy semantic models via XMLA |
+| `power-bi-deployment-pipeline` | Orchestrate multi-stage deployment pipelines |
+| `power-bi-filters` | Build and troubleshoot filter context |
+| `power-bi-layout` | Auto-layout and spacing for report pages |
+| `power-bi-partitions` | Manage incremental refresh and partition strategies |
+| `power-bi-performance` | Diagnose and optimise query and refresh performance |
+| `power-bi-testing` | Author and run DAX unit-test suites |
+| `power-bi-diagnostics` | Interpret Doctor output and resolve environment issues |
+| `power-bi-docs` | Generate and maintain data dictionaries |
+| `power-bi-pages` | Add, rename, and reorder report pages |
+| `power-bi-patterns` | Apply common Power BI design patterns |
+| `power-bi-design-system` | Enforce colour, typography, and UX consistency |
+| `power-bi-custom-visuals` | Import and configure custom visual packages |
+| `power-bi-page-designer` | Interactive page composition and alignment |
+| `power-bi-project-orchestrator` | Coordinate multi-skill Power BI projects end-to-end |
+| `power-bi-troubleshooter` | Diagnose and fix common Power BI errors |
+
+---
+
+## CI / CD
+
+```yaml
+# .github/workflows/pbi-governance.yml
+name: PBI Governance
+on: [push, pull_request]
+jobs:
+  govern:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with: { python-version: '3.12' }
+      - run: pip install "pbi-enterprise-cli[dev]"
+      - run: pbi --backend mock govern check
+      - run: pbi --backend mock dax test --suite tests/fixtures/
+```
+
+---
+
+## Global Flags
+
+These work with every command:
+
+| Flag | Purpose |
+|---|---|
+| `--backend desktop\|xmla\|mock` | Select backend (default: `desktop`) |
+| `--dry-run` | Preview changes without applying them |
+| `--json` | Machine-readable JSON output |
+| `--port 5000` | Desktop local server port |
+
+---
+
+## Environment Variables
+
+| Variable | Purpose |
+|---|---|
+| `ANTHROPIC_API_KEY` | Claude AI for `pbi measure generate` |
+| `PBI_REST_BEARER` | Default Bearer token for REST source profiling |
+| `PBI_CLIENT_ID` | AAD app client ID for XMLA service principal auth |
+| `PBI_CLIENT_SECRET` | AAD app client secret |
+| `PBI_TENANT_ID` | AAD tenant ID |
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/mudassir09/pbi-enterprise-cli.git
+cd pbi-enterprise-cli
+pip install -e ".[all]"
+
+# Run the full test suite (547 tests, ~4 s)
+python -m pytest
+
+# Lint
+ruff check src/ tests/
+```
+
+### CI notes
+
+- All tests run on **Python 3.10, 3.11, and 3.12** via GitHub Actions on `ubuntu-latest`.
+- `pbi doctor` works cross-platform — on Linux/macOS it gracefully reports pythonnet as unavailable instead of crashing.
+- Coverage is measured on testable code only; `tom_backend.py` (requires Windows/.NET) and `server/api.py` (requires a live server) are excluded from the coverage gate. The enforced minimum is **65%**.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for branch strategy and coding standards.
+
+---
+
+## License
+
+[MIT](LICENSE) — © 2026 Mudassir

pbi_enterprise_cli-0.1.0.dev0/README.pypi.md

@@ -0,0 +1,47 @@
+# pbi-enterprise-cli
+
+**Full-stack Power BI enterprise automation from the command line.**
+
+```bash
+pip install pbi-enterprise-cli
+pbi doctor          # verify setup
+pbi model tables    # list tables in the connected model
+pbi govern check    # run governance rules
+```
+
+## Feature highlights
+
+- **25 command groups** covering every layer of Power BI development
+- **32 visual types** — from cards to decomposition trees
+- **3 backends** — Desktop (TOM via pythonnet), XMLA (Premium/Fabric), Mock (CI)
+- **PBIR GA format** — read and write `.pbip` project files directly
+- **Governance engine** — 5 built-in rules + custom plugin system
+- **REST source profiling** — Bearer/API-key auth, OData pagination, star-schema scaffold
+- **REPL mode** — interactive session with tab completion and persistent history
+- **Custom visual SDK** — scaffold, build, package, import `.pbiviz`
+- **AI measure generation** — Claude API integration (requires `[ai]` extra)
+- **24 AI skills** — install Claude Code skills (`pbi skills install --all`)
+- **547 unit tests** passing on Python 3.10–3.12
+
+## Install options
+
+```bash
+pip install pbi-enterprise-cli             # base
+pip install "pbi-enterprise-cli[ai]"       # + Claude AI
+pip install "pbi-enterprise-cli[xmla]"     # + MSAL auth for XMLA
+pip install "pbi-enterprise-cli[sources]"  # + SQL/Excel/REST profiling
+pip install "pbi-enterprise-cli[all]"      # everything
+```
+
+## Requirements
+
+- Python 3.10+
+- Windows (for Desktop/XMLA backends using .NET AMO)
+- Power BI Desktop (for the `desktop` backend)
+
+## Links
+
+- [GitHub Repository](https://github.com/mudassir09/pbi-enterprise-cli)
+- [Full Documentation](https://github.com/mudassir09/pbi-enterprise-cli#readme)
+- [Changelog](https://github.com/mudassir09/pbi-enterprise-cli/blob/main/CHANGELOG.md)
+- [Security Policy](https://github.com/mudassir09/pbi-enterprise-cli/blob/main/SECURITY.md)

pbi_enterprise_cli-0.1.0.dev0/pyproject.toml

@@ -0,0 +1,81 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pbi-enterprise-cli"
+version = "0.1.0.dev0"
+description = "Power BI enterprise CLI — AI-driven model management, governance, PBIR authoring, XMLA, and DAX testing"
+readme = "README.pypi.md"
+requires-python = ">=3.10"
+license = { text = "MIT AND LicenseRef-Microsoft-AS-Client-Libraries" }
+keywords = ["power-bi", "cli", "dax", "tmdl", "pbir", "powerbi", "microsoft", "governance"]
+authors = [
+    { name = "Mudassir", email = "mir.mudassir1@gmail.com" },
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Information Technology",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Office/Business",
+]
+dependencies = [
+    "click>=8.1",
+    "rich>=13.0",
+    "pythonnet>=3.0",
+    "pydantic>=2.0",
+    "python-dotenv>=1.0",
+    "PyYAML>=6.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/mudassir09/pbi-enterprise-cli"
+Repository = "https://github.com/mudassir09/pbi-enterprise-cli"
+"Bug Tracker" = "https://github.com/mudassir09/pbi-enterprise-cli/issues"
+Changelog = "https://github.com/mudassir09/pbi-enterprise-cli/blob/main/CHANGELOG.md"
+
+[project.optional-dependencies]
+ai      = ["anthropic>=0.25"]
+viz     = ["Pillow>=10.0", "python-wcag-contrast-ratio>=1.0", "playwright>=1.44"]
+xmla    = ["msal>=1.28"]
+server  = ["fastapi>=0.110", "uvicorn>=0.29"]
+sources = ["sqlalchemy>=2.0", "openpyxl>=3.1", "httpx>=0.27"]
+dev     = ["pytest>=7.0", "pytest-cov>=4.0", "ruff>=0.4.0", "mypy>=1.10"]
+all     = ["pbi-enterprise-cli[ai,viz,xmla,server,sources,dev]"]
+
+[project.scripts]
+pbi = "pbi_cli.cli:cli"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP"]
+
+[tool.mypy]
+python_version = "3.10"
+ignore_missing_imports = true
+warn_unused_ignores = false
+# strict mode is disabled: backends use pythonnet/AMO dynamic dispatch (Any is intentional)
+
+[tool.coverage.run]
+omit = [
+    "src/pbi_cli/backends/tom_backend.py",
+    "src/pbi_cli/server/api.py",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = ["e2e: requires live Power BI Desktop or XMLA endpoint"]

pbi_enterprise_cli-0.1.0.dev0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pbi_enterprise_cli-0.1.0.dev0/src/pbi_cli/__init__.py

@@ -0,0 +1,3 @@
+"""pbi-cli: Power BI one-stop-shop platform for AI-driven development."""
+
+__version__ = "0.1.0.dev0"

pbi_enterprise_cli-0.1.0.dev0/src/pbi_cli/_audit.py

@@ -0,0 +1,57 @@
+"""Append-only audit log for all pbi-cli write operations (Epic D6)."""
+
+from __future__ import annotations
+
+import datetime
+import getpass
+import json
+from pathlib import Path
+from typing import Any
+
+_AUDIT_FILE = Path.home() / ".pbi-cli" / "audit.jsonl"
+
+
+def write_audit_entry(
+    command: str,
+    before: Any = None,
+    after: Any = None,
+    extra: dict[str, Any] | None = None,
+) -> None:
+    """Append one JSON line to ~/.pbi-cli/audit.jsonl."""
+    _AUDIT_FILE.parent.mkdir(parents=True, exist_ok=True)
+    entry: dict[str, Any] = {
+        "timestamp": datetime.datetime.now(datetime.timezone.utc).isoformat(),
+        "user": _get_user(),
+        "command": command,
+    }
+    if before is not None:
+        entry["before"] = before
+    if after is not None:
+        entry["after"] = after
+    if extra:
+        entry.update(extra)
+    with _AUDIT_FILE.open("a", encoding="utf-8") as f:
+        f.write(json.dumps(entry, default=str) + "\n")
+
+
+def read_audit_log(limit: int = 50) -> list[dict[str, Any]]:
+    """Return the last *limit* audit entries (most-recent last)."""
+    if not _AUDIT_FILE.exists():
+        return []
+    lines = _AUDIT_FILE.read_text(encoding="utf-8").splitlines()
+    entries = []
+    for line in lines:
+        line = line.strip()
+        if line:
+            try:
+                entries.append(json.loads(line))
+            except json.JSONDecodeError:
+                pass
+    return entries[-limit:]
+
+
+def _get_user() -> str:
+    try:
+        return getpass.getuser()
+    except Exception:
+        return "unknown"