ado-git-repo-insights 2.7.5__tar.gz → 3.2.0__tar.gz

{ado_git_repo_insights-2.7.5 → ado_git_repo_insights-3.2.0}/.gitattributes

@@ -1,6 +1,13 @@
 # Default: auto-detect text files, normalize to LF in repo
 * text=auto eol=lf
 
+# ─────────────────────────────────────────────────────────
+# GIT CONFIGURATION FILES: Always LF
+# ─────────────────────────────────────────────────────────
+.gitattributes text eol=lf
+.gitignore text eol=lf
+.gitmodules text eol=lf
+
 # ─────────────────────────────────────────────────────────
 # SCRIPTS: Must always be LF (executed in Unix CI)
 # ─────────────────────────────────────────────────────────
@@ -11,6 +18,13 @@
 .github/** text eol=lf
 scripts/** text eol=lf
 
+# ─────────────────────────────────────────────────────────
+# CI/CD CONFIGURATION: LF for cross-platform CI
+# ─────────────────────────────────────────────────────────
+Dockerfile text eol=lf
+docker-compose*.yml text eol=lf
+Makefile text eol=lf
+
 # ─────────────────────────────────────────────────────────
 # CODE: LF for cross-platform consistency
 # ─────────────────────────────────────────────────────────
@@ -21,6 +35,8 @@ scripts/** text eol=lf
 *.yml text eol=lf
 *.yaml text eol=lf
 *.md text eol=lf
+*.txt text eol=lf
+LICENSE text eol=lf
 *.html text eol=lf
 *.css text eol=lf
 

{ado_git_repo_insights-2.7.5 → ado_git_repo_insights-3.2.0}/.gitignore

@@ -45,6 +45,7 @@ coverage.xml
 *.py,cover
 .hypothesis/
 .pytest_cache/
+coverage/
 
 # Translations
 *.mo

{ado_git_repo_insights-2.7.5 → ado_git_repo_insights-3.2.0}/CHANGELOG.md

@@ -1,3 +1,99 @@
+# [3.2.0](https://github.com/oddessentials/ado-git-repo-insights/compare/v3.1.0...v3.2.0) (2026-01-18)
+
+
+### Bug Fixes
+
+* **dashboard:** accept PartiallySucceeded builds and handle stale settings ([f6c3135](https://github.com/oddessentials/ado-git-repo-insights/commit/f6c3135012a857b74c3d8d22a3a8032a470bde56))
+
+
+### Features
+
+* **dashboard:** add feature flag for Phase 5 tabs with Coming Soon state ([a604462](https://github.com/oddessentials/ado-git-repo-insights/commit/a604462a8edf1f2059a8d23f736d4b26486154a4))
+
+# [3.1.0](https://github.com/oddessentials/ado-git-repo-insights/compare/v3.0.4...v3.1.0) (2026-01-17)
+
+
+### Features
+
+* **dashboard:** add comparison mode and export functionality (Sprint 5) ([e3fde36](https://github.com/oddessentials/ado-git-repo-insights/commit/e3fde3600f8fd67b13086333abe0c4b54b9b8412))
+* **dashboard:** add cycle time trend and reviewer activity charts (Sprint 4) ([93e14dd](https://github.com/oddessentials/ado-git-repo-insights/commit/93e14dd3118d61922293edacc43762ddc0f21fdc))
+* **dashboard:** add dimension filter bar with dropdowns (Sprint 2) ([393ede3](https://github.com/oddessentials/ado-git-repo-insights/commit/393ede3b8b44f8e9270bbabd03d9146d5f231385))
+* **dashboard:** add raw data ZIP download for pipeline CSV artifacts ([5785d18](https://github.com/oddessentials/ado-git-repo-insights/commit/5785d18aaa33eda95c7c252e266e2cd9c87fd9e2))
+* **dashboard:** add sparklines and trend line overlay (Sprint 3) ([8781ddb](https://github.com/oddessentials/ado-git-repo-insights/commit/8781ddb7bbaab71cd9e2dcd5de383a1563f41a7c))
+* **dashboard:** add trend deltas and reviewers card (Sprint 1) ([660546d](https://github.com/oddessentials/ado-git-repo-insights/commit/660546d526632998f184c3d698a5c030e7f46d82))
+
+## [3.0.4](https://github.com/oddessentials/ado-git-repo-insights/compare/v3.0.3...v3.0.4) (2026-01-17)
+
+
+### Bug Fixes
+
+* white spacing ([29f5f4d](https://github.com/oddessentials/ado-git-repo-insights/commit/29f5f4d413492f0e41b486d2762932e754b1e95d))
+
+## [3.0.3](https://github.com/oddessentials/ado-git-repo-insights/compare/v3.0.2...v3.0.3) (2026-01-17)
+
+
+### Bug Fixes
+
+* **artifact:** use downloadUrl with format=file&subPath (verified working) ([be53de4](https://github.com/oddessentials/ado-git-repo-insights/commit/be53de426619285a782f97f96556cb41836c3846))
+
+## [3.0.2](https://github.com/oddessentials/ado-git-repo-insights/compare/v3.0.1...v3.0.2) (2026-01-17)
+
+
+### Bug Fixes
+
+* **artifact:** remove duplicated aggregates/ prefix from file paths ([d19688e](https://github.com/oddessentials/ado-git-repo-insights/commit/d19688eb27652de571273922ed496f56c5d6410f))
+* **artifact:** try Container API for PipelineArtifacts first ([63376ca](https://github.com/oddessentials/ado-git-repo-insights/commit/63376caf8aca5b0aee281b10b7f7e9f53aa4ceb4))
+
+## [3.0.1](https://github.com/oddessentials/ado-git-repo-insights/compare/v3.0.0...v3.0.1) (2026-01-17)
+
+
+### Bug Fixes
+
+* **artifact:** correct Pipeline Artifact file URL construction ([9eb9b3c](https://github.com/oddessentials/ado-git-repo-insights/commit/9eb9b3c28406c0307d1704d71d25ff94700ec5a3))
+
+# [3.0.0](https://github.com/oddessentials/ado-git-repo-insights/compare/v2.8.2...v3.0.0) (2026-01-17)
+
+
+### Bug Fixes
+
+* **artifact:** use getArtifacts lookup instead of broken SDK getArtifact ([6f6ad55](https://github.com/oddessentials/ado-git-repo-insights/commit/6f6ad559eb6c7f5f2f98840122b95b61b119153e))
+
+
+### BREAKING CHANGES
+
+* **artifact:** Replaced SDK-based artifact metadata retrieval with
+direct API lookup. This fixes cross-project artifact access but changes
+the internal implementation approach.
+
+## [2.8.2](https://github.com/oddessentials/ado-git-repo-insights/compare/v2.8.1...v2.8.2) (2026-01-17)
+
+
+### Bug Fixes
+
+* **artifact:** use resource.url directly for container file access ([92f6f85](https://github.com/oddessentials/ado-git-repo-insights/commit/92f6f8523fd4bc219f2b0108d5727b7f2990b9d2))
+
+## [2.8.1](https://github.com/oddessentials/ado-git-repo-insights/compare/v2.8.0...v2.8.1) (2026-01-17)
+
+
+### Bug Fixes
+
+* **artifact:** use SDK-based file access to resolve 401 errors ([f81c884](https://github.com/oddessentials/ado-git-repo-insights/commit/f81c884cbdf39589e2a877885bed5e328c07e63d))
+
+# [2.8.0](https://github.com/oddessentials/ado-git-repo-insights/compare/v2.7.6...v2.8.0) (2026-01-16)
+
+
+### Features
+
+* **dashboard:** use configured source project for cross-project access ([54fa822](https://github.com/oddessentials/ado-git-repo-insights/commit/54fa822231dc5f00ed32fa2aeb74206bef2bca48))
+* **settings:** add cross-project support with graceful degradation ([bfb8009](https://github.com/oddessentials/ado-git-repo-insights/commit/bfb8009087dd21605a617ec0699109c42df88811))
+
+## [2.7.6](https://github.com/oddessentials/ado-git-repo-insights/compare/v2.7.5...v2.7.6) (2026-01-16)
+
+
+### Bug Fixes
+
+* **extension:** add queryOrder to all getDefinitions calls ([b74be8a](https://github.com/oddessentials/ado-git-repo-insights/commit/b74be8a0ea42d4b8bf81e73e31d088a504133ecd))
+
 ## [2.7.5](https://github.com/oddessentials/ado-git-repo-insights/compare/v2.7.4...v2.7.5) (2026-01-16)
 
 

ado_git_repo_insights-3.2.0/DEFERRED-PHASE5.md

@@ -0,0 +1,207 @@
+# Deferred Work: Phase 5 (Predictions & AI Insights)
+
+This document outlines the work required to enable Phase 5 features (Predictions and AI Insights tabs) in the PR Insights dashboard. These features are currently disabled via feature flag.
+
+---
+
+## Current State
+
+- **Feature Flag**: `ENABLE_PHASE5_FEATURES = false` in `extension/ui/dashboard.js`
+- **Tabs**: Hidden by default, showing "Coming Soon" state when manually revealed
+- **ML Code**: Exists in `src/ado_git_repo_insights/ml/` but not integrated with pipeline task
+- **Pipeline Task**: Does not expose `enablePredictions` or `enableInsights` inputs
+
+---
+
+## Prerequisites for Enablement
+
+### 1. Python Dependencies
+
+The ML features require additional Python packages not currently in the base requirements:
+
+```python
+# Forecaster (predictions/trends.json)
+prophet>=1.1.0  # Facebook Prophet for time series forecasting
+
+# AI Insights (insights/summary.json)
+openai>=1.0.0   # OpenAI API client (optional, for AI-powered insights)
+```
+
+**Files to update**:
+- `setup.py` - Add optional extras_require for ML features
+- `pyproject.toml` - Add optional dependency group
+
+### 2. Pipeline Task Inputs
+
+The `ExtractPullRequests@2` task needs new inputs to enable ML features:
+
+```yaml
+# Proposed new inputs for extension/tasks/extract-prs/task.json
+{
+  "name": "enablePredictions",
+  "type": "boolean",
+  "label": "Generate ML Predictions",
+  "defaultValue": "false",
+  "required": false,
+  "helpMarkDown": "Generate time series forecasts for cycle time and throughput"
+},
+{
+  "name": "enableInsights",
+  "type": "boolean",
+  "label": "Generate AI Insights",
+  "defaultValue": "false",
+  "required": false,
+  "helpMarkDown": "Generate AI-powered analysis (requires OpenAI API key)"
+},
+{
+  "name": "openaiApiKey",
+  "type": "string",
+  "label": "OpenAI API Key",
+  "required": false,
+  "helpMarkDown": "API key for AI insights generation (required if enableInsights is true)"
+}
+```
+
+**Files to update**:
+- `extension/tasks/extract-prs/task.json` - Add input definitions
+- `extension/tasks/extract-prs/index.js` - Pass inputs to Python CLI
+- CLI command builder to include `--enable-predictions` and `--enable-insights` flags
+
+### 3. CLI Integration
+
+The CLI already has flags for predictions/insights but they need to be wired through:
+
+```bash
+# Current CLI flags (cli.py)
+--enable-predictions    # Generate predictions/trends.json
+--enable-insights       # Generate insights/summary.json
+```
+
+**Files to verify**:
+- `src/ado_git_repo_insights/cli.py` - Flags exist at lines 612-613
+- `src/ado_git_repo_insights/ml/forecaster.py` - Prophet-based forecasting
+- `src/ado_git_repo_insights/ml/insights.py` - AI insights generation
+
+### 4. Dataset Contract Updates
+
+The aggregates output needs to include predictions and insights when enabled:
+
+```
+aggregates/
+├── dataset-manifest.json     # Must include predictions/insights flags
+├── weekly_rollups/
+├── distributions/
+├── predictions/              # NEW: when enablePredictions=true
+│   └── trends.json
+└── insights/                 # NEW: when enableInsights=true
+    └── summary.json
+```
+
+**Files to update**:
+- `docs/dataset-contract.md` - Document predictions/insights schema
+- Aggregator code to conditionally generate these files
+
+---
+
+## Implementation Tasks
+
+### Phase 5.1: Dependencies & CLI Wiring
+
+1. [ ] Add Prophet to optional dependencies in setup.py/pyproject.toml
+2. [ ] Add OpenAI to optional dependencies
+3. [ ] Verify CLI flags work end-to-end locally
+4. [ ] Add integration tests for predictions generation
+5. [ ] Add integration tests for insights generation
+
+### Phase 5.2: Pipeline Task Integration
+
+1. [ ] Add `enablePredictions` input to task.json
+2. [ ] Add `enableInsights` input to task.json
+3. [ ] Add `openaiApiKey` input to task.json
+4. [ ] Update index.js to pass new inputs to CLI
+5. [ ] Test in hosted agent environment (Prophet installation)
+6. [ ] Document agent requirements (Prophet needs C++ compiler)
+
+### Phase 5.3: Dashboard Integration
+
+1. [ ] Verify `loadPredictions()` in dataset-loader.js works with real data
+2. [ ] Verify `loadInsights()` in dataset-loader.js works with real data
+3. [ ] Update `renderPredictions()` for production data format
+4. [ ] Update `renderInsights()` for production data format
+5. [ ] Add loading states for async prediction/insight loading
+
+### Phase 5.4: Documentation & Enablement
+
+1. [ ] Create "Enable ML Features" documentation page
+2. [ ] Document OpenAI API key setup
+3. [ ] Document Prophet installation requirements
+4. [ ] Update INSTALLATION.md with ML features section
+5. [ ] Set `ENABLE_PHASE5_FEATURES = true` in dashboard.js
+6. [ ] Update tests to expect tabs visible by default
+
+---
+
+## Key Files Reference
+
+### Python ML Code
+- `src/ado_git_repo_insights/ml/__init__.py` - ML module exports
+- `src/ado_git_repo_insights/ml/forecaster.py` - Prophet-based cycle time forecasting
+- `src/ado_git_repo_insights/ml/insights.py` - AI-powered insights generation
+- `src/ado_git_repo_insights/ml/date_utils.py` - Date utilities for forecasting
+
+### Pipeline Task
+- `extension/tasks/extract-prs/task.json` - Task input definitions
+- `extension/tasks/extract-prs/index.js` - Task execution wrapper
+
+### Dashboard
+- `extension/ui/dashboard.js` - Feature flag and initialization
+- `extension/ui/dataset-loader.js` - Data loading for predictions/insights
+- `extension/ui/index.html` - Tab HTML structure
+
+### Tests
+- `extension/tests/production-issues.test.js` - Feature flag tests
+- Need to add: ML integration tests
+
+---
+
+## Risks & Considerations
+
+### Prophet Installation
+- Prophet requires C++ compiler and additional build tools
+- May fail on some self-hosted agents without proper toolchain
+- Consider: Pre-built wheel distribution or Docker-based execution
+
+### OpenAI API Costs
+- AI insights require OpenAI API calls (paid service)
+- Need rate limiting and cost estimation in documentation
+- Consider: Local LLM alternative for privacy-conscious users
+
+### Data Volume
+- Forecasting on large datasets (10k+ PRs) may be slow
+- Consider: Caching, incremental updates, time limits
+
+---
+
+## When to Enable
+
+Enable Phase 5 features when:
+
+1. All Phase 5.1-5.4 tasks are complete
+2. Integration tests pass in CI
+3. Documentation is complete
+4. At least one production user has tested successfully
+
+To enable:
+```javascript
+// extension/ui/dashboard.js line 34
+const ENABLE_PHASE5_FEATURES = true;
+```
+
+---
+
+## Contact
+
+For questions about Phase 5 implementation, see:
+- `docs/phase5-contract-notes.md` - Original design notes
+- `agents/INVARIANTS.md` - System invariants to preserve
+- GitHub Issues - For tracking specific tasks

{ado_git_repo_insights-2.7.5/src/ado_git_repo_insights.egg-info → ado_git_repo_insights-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ado-git-repo-insights
-Version: 2.7.5
+Version: 3.2.0
 Summary: Extract Azure DevOps Pull Request metrics to SQLite and generate PowerBI-compatible CSVs.
 Author-email: "Odd Essentials, LLC" <admin@oddessentials.com>
 License: MIT
@@ -41,6 +41,18 @@ Dynamic: license-file
 
 Extract Azure DevOps Pull Request metrics to SQLite and generate PowerBI-compatible CSVs.
 
+---
+
+## 🚀 Get Started
+
+**Install from the Azure DevOps Marketplace:**
+
+[![Install from Marketplace](https://img.shields.io/badge/Install-Azure%20DevOps%20Marketplace-blue?logo=azure-devops)](https://marketplace.visualstudio.com/items?itemName=OddEssentials.ado-git-repo-insights)
+
+👉 **New to this extension?** Follow the **[Installation Guide](docs/INSTALLATION.md)** for step-by-step setup instructions.
+
+---
+
 ## Overview
 
 This tool replaces the MongoDB-based `ado-pull-request-metrics` with a lightweight, file-based solution that:

{ado_git_repo_insights-2.7.5 → ado_git_repo_insights-3.2.0}/README.md

@@ -7,6 +7,18 @@
 
 Extract Azure DevOps Pull Request metrics to SQLite and generate PowerBI-compatible CSVs.
 
+---
+
+## 🚀 Get Started
+
+**Install from the Azure DevOps Marketplace:**
+
+[![Install from Marketplace](https://img.shields.io/badge/Install-Azure%20DevOps%20Marketplace-blue?logo=azure-devops)](https://marketplace.visualstudio.com/items?itemName=OddEssentials.ado-git-repo-insights)
+
+👉 **New to this extension?** Follow the **[Installation Guide](docs/INSTALLATION.md)** for step-by-step setup instructions.
+
+---
+
 ## Overview
 
 This tool replaces the MongoDB-based `ado-pull-request-metrics` with a lightweight, file-based solution that:

ado_git_repo_insights-3.2.0/VERSION

@@ -0,0 +1 @@
+3.2.0