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

{ado_git_repo_insights-2.7.5 → ado_git_repo_insights-3.3.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.3.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.3.0}/CHANGELOG.md

@@ -1,3 +1,113 @@
+# [3.3.0](https://github.com/oddessentials/ado-git-repo-insights/compare/v3.2.0...v3.3.0) (2026-01-18)
+
+
+### Bug Fixes
+
+* revert manual version bump, remove obsolete planning doc ([df019c0](https://github.com/oddessentials/ado-git-repo-insights/commit/df019c0738ddc0b3b684e940ed8fcd272e879dec))
+* **tests:** resolve ruff linting errors in Phase 5 ML tests ([d816e36](https://github.com/oddessentials/ado-git-repo-insights/commit/d816e3697d1993369f4be82df563faad7d8b435e))
+
+
+### Features
+
+* **dashboard:** enable Phase 5 features (Predictions & AI Insights tabs) ([649f39e](https://github.com/oddessentials/ado-git-repo-insights/commit/649f39e17ca7c778133aed2dba8df0bf360d4b03))
+* **task:** add Phase 5 ML inputs to pipeline task (v2.3.0) ([314c560](https://github.com/oddessentials/ado-git-repo-insights/commit/314c56045ecc531cec7cf60d94b180dc9655b2ea))
+
+# [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-2.7.5/src/ado_git_repo_insights.egg-info → ado_git_repo_insights-3.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ado-git-repo-insights
-Version: 2.7.5
+Version: 3.3.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.3.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.3.0/VERSION

@@ -0,0 +1 @@
+3.3.0

ado_git_repo_insights-3.3.0/docs/DEFAULT-DASHBOARD-ENHANCEMENT-PLAN.md

@@ -0,0 +1,472 @@
+# Default Dashboard Enhancement Plan
+
+This document outlines a multi-phase implementation plan to enhance the default dashboard, making it more useful and impressive based on existing data and our initial vision.
+
+## Executive Summary
+
+The current default dashboard provides a solid foundation but leaves significant value untapped. Two essential gaps prevent us from delivering on our original vision:
+
+1. **Filters** - Dimension-based filtering (repo, team, author) exists in the data contract but not in the UI
+2. **Comparative Trend Analysis** - No period-over-period comparison, trend indicators, or delta context
+
+This plan addresses both gaps through four implementation phases, progressively transforming the dashboard from a static snapshot view into an interactive, insight-rich analytics experience.
+
+---
+
+## Gap Analysis
+
+### What We Have (Current State)
+
+| Component | Status | Notes |
+|-----------|--------|-------|
+| Summary Cards | 4 metrics | Total PRs, Cycle P50/P90, Contributors |
+| Charts | 2 visualizations | Throughput bars, Distribution stacked bar |
+| Date Range Filter | Implemented | Presets + custom picker |
+| Dimension Filters | **Not implemented** | Schema ready in `dimensions.json` |
+| Trend Indicators | **Not implemented** | No delta/direction context |
+| Reviewer Metrics | **Data loaded, not displayed** | `reviewers_count` in weekly rollups |
+| Period Comparison | **Not implemented** | No side-by-side analysis |
+
+### Data Already Available (Untapped)
+
+From `weekly_rollups/YYYY-Www.json`:
+- `reviewers_count` - Loaded but never displayed
+- Historical data - Available for trend calculation
+- Week-over-week deltas - Computable from existing data
+
+From `distributions/YYYY.json`:
+- `prs_by_month` - Could power monthly trend view
+- Multi-year distributions - Available for year-over-year comparison
+
+From `dimensions.json`:
+- Organization, Project, Repository, Team names - Ready for filter dropdowns
+
+---
+
+## Implementation Phases
+
+### Phase A: Trend Indicators & Metric Expansion
+
+**Goal**: Transform summary cards from static numbers to dynamic trend-aware metrics.
+
+#### A.1 - Add Trend Deltas to Summary Cards
+
+Add delta indicators showing change from previous period:
+
+```
+┌─────────────────────┐  ┌─────────────────────┐
+│  Total PRs          │  │  Cycle Time P50     │
+│      247            │  │      4.2 hrs        │
+│   ▲ +12% vs prev    │  │   ▼ -8% vs prev     │
+└─────────────────────┘  └─────────────────────┘
+```
+
+**Implementation Details**:
+- Compare current period to previous equivalent period
+- For 30-day view: compare to previous 30 days
+- For 90-day view: compare to previous 90 days
+- Show percentage change with directional arrow
+- Color coding: green (improvement), red (regression), gray (neutral)
+- Neutral threshold: ±2% to avoid noise
+
+**Files to modify**:
+- `extension/ui/dashboard.js`: Add `calculateTrendDelta()` function
+- `extension/ui/styles.css`: Add `.metric-delta`, `.delta-positive`, `.delta-negative` classes
+
+#### A.2 - Add Reviewers Card (5th Summary Card)
+
+Display the `reviewers_count` data that's already being loaded:
+
+```
+┌─────────────────────┐
+│  Reviewers          │
+│      18             │
+│   ▲ +3 vs prev      │
+└─────────────────────┘
+```
+
+**Implementation Details**:
+- Calculate average reviewers per week across selected range
+- Show delta vs previous period
+- Position in summary card row (may need responsive layout adjustment)
+
+#### A.3 - Add Sparkline Mini-Charts to Cards
+
+Add small inline trend visualizations to each summary card:
+
+```
+┌─────────────────────┐
+│  Total PRs          │
+│      247   ╱╲_╱─    │  ← 8-week sparkline
+│   ▲ +12% vs prev    │
+└─────────────────────┘
+```
+
+**Implementation Details**:
+- Render last 8 data points as SVG sparkline
+- No axis labels (space-constrained)
+- Single-color line matching metric theme
+- Optional: Add hover tooltip with value
+
+**Files to modify**:
+- `extension/ui/dashboard.js`: Add `renderSparkline()` function
+- `extension/ui/styles.css`: Add `.sparkline-container` styles
+
+---
+
+### Phase B: Dimension Filters
+
+**Goal**: Enable users to slice data by repository, team, and other dimensions.
+
+#### B.1 - Filter Bar UI Component
+
+Add a horizontal filter bar below the date range selector:
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ Date Range: [Last 90 days ▼]                                │
+├─────────────────────────────────────────────────────────────┤
+│ Repository: [All ▼]  Team: [All ▼]  Author: [All ▼]  [Clear]│
+└─────────────────────────────────────────────────────────────┘
+```
+
+**Implementation Details**:
+- Multi-select dropdowns with search/filter capability
+- "All" as default selection
+- Clear button to reset all filters
+- Filters persist in URL query params (shareable)
+- Load dimensions from `dimensions.json`
+
+**Files to modify**:
+- `extension/ui/index.html`: Add filter bar HTML structure
+- `extension/ui/dashboard.js`: Add filter state management, `applyFilters()`
+- `extension/ui/dataset-loader.js`: Add dimension loading
+- `extension/ui/styles.css`: Add `.filter-bar`, `.filter-dropdown` styles
+
+#### B.2 - Backend Filter Support
+
+Extend the aggregates generator to support dimension-filtered data:
+
+**Option A - Pre-computed dimension slices** (recommended for MVP):
+- Generate separate rollup files per dimension combination
+- Structure: `weekly_rollups/YYYY-Www/repo-{repoId}.json`
+- Pro: Fast UI, no runtime computation
+- Con: More files, storage growth
+
+**Option B - Client-side filtering**:
+- Load full data, filter in JavaScript
+- Pro: Simple backend, fewer files
+- Con: Slower for large datasets
+
+**Recommendation**: Start with Option B for MVP, migrate to Option A if performance degrades.
+
+#### B.3 - Filter Chip Display
+
+Show active filters as removable chips:
+
+```
+│ Filtering by: [repo:backend ✕] [team:platform ✕]            │
+```
+
+**Implementation Details**:
+- Chips appear when non-default filter selected
+- Click ✕ to remove individual filter
+- Compact display that doesn't crowd the UI
+
+---
+
+### Phase C: Enhanced Visualizations
+
+**Goal**: Add richer chart types that surface deeper insights from existing data.
+
+#### C.1 - Trend Line Overlay on Throughput Chart
+
+Add a trend line (moving average) to the existing bar chart:
+
+```
+     PR Throughput Over Time
+  40│    ▂▄    ═══════════════  ← 4-week moving average
+  30│  ▄▆██▆▄▂▄▆█▆▄▂
+  20│▄▆████████████▆▄
+  10│██████████████████
+    └────────────────────────
+     W1 W2 W3 W4 W5 W6 W7 W8
+```
+
+**Implementation Details**:
+- Calculate 4-week simple moving average
+- Overlay as line on existing bar chart
+- Different color (e.g., orange) to distinguish from bars
+- Optional: Toggle to show/hide trend line
+
+#### C.2 - Reviewer Activity Chart (New)
+
+Add a new chart showing reviewer engagement:
+
+```
+     Review Activity
+  ┌─────────────────────┐
+  │ ████████████ 18 rev │  Week 1
+  │ ██████████   15 rev │  Week 2
+  │ ████████████████ 22 │  Week 3
+  └─────────────────────┘
+```
+
+**Implementation Details**:
+- Horizontal bar chart showing reviewers_count per week
+- Complements the throughput chart (authors produce, reviewers consume)
+- Helps identify review bottlenecks
+
+#### C.3 - Cycle Time Trend Chart (New)
+
+Replace or complement the distribution chart with a time-series view:
+
+```
+     Cycle Time Trend (P50 vs P90)
+  hrs
+  24│         ╱╲
+  16│    ╱╲__╱  ╲____  P90
+   8│___╱              P50
+    └────────────────────────
+     W1 W2 W3 W4 W5 W6 W7 W8
+```
+
+**Implementation Details**:
+- Dual-line chart showing P50 and P90 over time
+- Helps identify if cycle time is improving/degrading
+- Legend with current values
+
+#### C.4 - Chart Interactivity
+
+Add hover tooltips and click interactions:
+
+**Hover**: Show exact values
+```
+   ┌──────────────────┐
+   │ Week 23, 2024    │
+   │ PRs: 34          │
+   │ Cycle P50: 3.2h  │
+   └──────────────────┘
+```
+
+**Click**: Drill-down potential (sets date filter to that week)
+
+---
+
+### Phase D: Comparison Mode & Advanced Features
+
+**Goal**: Enable powerful side-by-side analysis and polish the experience.
+
+#### D.1 - Period Comparison Mode
+
+Add a toggle to enable comparison view:
+
+```
+[Comparison Mode: ON]
+Compare: [This month ▼] vs [Previous month ▼]
+
+┌─────────────────────────────────────────────────────────────┐
+│         This Month          │       Previous Month         │
+├─────────────────────────────┼──────────────────────────────┤
+│  Total PRs: 247             │  Total PRs: 221              │
+│  Cycle P50: 4.2 hrs         │  Cycle P50: 4.6 hrs          │
+│  Contributors: 12           │  Contributors: 11            │
+├─────────────────────────────┴──────────────────────────────┤
+│            Side-by-side charts here                        │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**Implementation Details**:
+- Toggle button to enter/exit comparison mode
+- Two date range pickers in comparison mode
+- Side-by-side summary cards
+- Overlaid or side-by-side charts
+- Delta summary at bottom
+
+#### D.2 - Export Functionality
+
+Add ability to export current view:
+
+```
+[Export ▼]
+├── Export as CSV
+├── Export as PNG (screenshot)
+└── Copy shareable link
+```
+
+**Implementation Details**:
+- CSV: Export filtered data as downloadable CSV
+- PNG: Use html2canvas or similar for chart screenshots
+- Link: Copy current URL with all filters encoded
+
+#### D.3 - Dashboard Presets / Saved Views
+
+Allow users to save filter combinations:
+
+```
+[Saved Views ▼]
+├── + Save current view
+├── ─────────────
+├── Backend Team - Last 30 days
+└── Platform Monthly Review
+```
+
+**Implementation Details**:
+- Save to user's extension settings
+- Store: filter values, date range, comparison mode state
+- Quick switch between saved configurations
+
+#### D.4 - Responsive Layout Improvements
+
+Ensure dashboard works well on various screen sizes:
+
+- Tablet: Stack charts vertically, compress filter bar
+- Large monitor: Expand to show more weeks, larger charts
+- Print: Clean layout for PDF export
+
+---
+
+## Implementation Priority Matrix
+
+| Feature | User Value | Effort | Data Ready | Priority |
+|---------|------------|--------|------------|----------|
+| Trend deltas on cards | High | Low | Yes | **P0** |
+| Reviewers card | Medium | Low | Yes | **P0** |
+| Repository filter | High | Medium | Yes | **P1** |
+| Team filter | High | Medium | Yes | **P1** |
+| Sparklines on cards | Medium | Medium | Yes | **P1** |
+| Trend line overlay | Medium | Low | Yes | **P1** |
+| Cycle time trend chart | High | Medium | Yes | **P2** |
+| Reviewer activity chart | Medium | Medium | Yes | **P2** |
+| Chart hover tooltips | Medium | Low | Yes | **P2** |
+| Comparison mode | High | High | Yes | **P3** |
+| Export functionality | Medium | Medium | Yes | **P3** |
+| Saved views | Low | Medium | Yes | **P4** |
+
+---
+
+## Recommended Implementation Order
+
+### Sprint 1: Quick Wins (Phase A.1 + A.2)
+- Add trend deltas to existing 4 summary cards
+- Add 5th card for reviewers
+- Estimated scope: ~2-3 days development
+
+### Sprint 2: Filters Foundation (Phase B.1 + B.2)
+- Add filter bar UI component
+- Implement client-side filtering
+- Add filter chips display
+- Estimated scope: ~3-4 days development
+
+### Sprint 3: Visual Polish (Phase A.3 + C.1)
+- Add sparklines to summary cards
+- Add trend line overlay to throughput chart
+- Estimated scope: ~2-3 days development
+
+### Sprint 4: Chart Expansion (Phase C.2 + C.3 + C.4)
+- Add reviewer activity chart
+- Add cycle time trend chart
+- Add hover tooltips to all charts
+- Estimated scope: ~3-4 days development
+
+### Sprint 5: Advanced Features (Phase D.1 + D.2)
+- Implement comparison mode
+- Add export functionality
+- Estimated scope: ~4-5 days development
+
+---
+
+## Success Metrics
+
+After full implementation, the dashboard should enable users to answer:
+
+1. **Trend Questions**
+   - "Is our cycle time improving or getting worse?"
+   - "How does this month compare to last month?"
+   - "Are we merging more or fewer PRs than before?"
+
+2. **Filter Questions**
+   - "How is the backend team performing vs frontend?"
+   - "Which repository has the longest cycle times?"
+   - "How do my PRs compare to the team average?"
+
+3. **Capacity Questions**
+   - "Do we have enough reviewers for our PR volume?"
+   - "Is reviewer participation increasing or declining?"
+   - "Are certain teams bottlenecked on reviews?"
+
+---
+
+## Technical Considerations
+
+### No Schema Changes Required
+All features in this plan use existing data from:
+- `weekly_rollups/YYYY-Www.json` - Already has all needed fields
+- `distributions/YYYY.json` - Already has time buckets and monthly data
+- `dimensions.json` - Already has filter dimensions
+
+### Backward Compatibility
+- All enhancements are additive to the UI
+- No changes to data contracts or schemas
+- Existing datasets work without regeneration
+
+### Performance
+- Sparklines: Lightweight SVG, minimal overhead
+- Filters: Client-side for MVP, can optimize later
+- Comparison mode: Loads two date ranges, may need loading indicator
+
+---
+
+## Appendix: Mockups
+
+### Summary Cards with Trends (Phase A Complete)
+
+```
+┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
+│ Total PRs   │ │ Cycle P50   │ │ Cycle P90   │ │ Contributors│ │ Reviewers   │
+│    247      │ │   4.2 hrs   │ │  12.8 hrs   │ │     12      │ │     18      │
+│  ╱╲_╱─╲     │ │  _╱╲__╱─    │ │  ─╲_╱╲_     │ │  ╱─╲_╱─     │ │  ─╱╲_╱─     │
+│ ▲ +12%      │ │ ▼ -8%       │ │ ▼ -15%      │ │ ▲ +2        │ │ ▲ +3        │
+└─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘
+```
+
+### Filter Bar (Phase B Complete)
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ Date Range: [Last 90 days ▼]  [Jun 1 - Aug 31, 2024]                       │
+├─────────────────────────────────────────────────────────────────────────────┤
+│ Repository: [backend, api ▼]  Team: [All ▼]  Author: [All ▼]  [Clear All]  │
+│ Active: [backend ✕] [api ✕]                                                 │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### Enhanced Charts (Phase C Complete)
+
+```
+     PR Throughput Over Time                    Cycle Time Trend
+  40│    ▂▄══════════════════             24│         ╱╲
+  30│  ▄▆██▆▄▂▄▆█▆▄▂                      16│    ╱╲__╱  ╲____ P90
+  20│▄▆████████████▆▄                      8│___╱              P50
+  10│██████████████████                     └────────────────────
+    └────────────────────                    W1 W2 W3 W4 W5 W6
+     W1 W2 W3 W4 W5 W6 W7 W8
+                                           Review Activity
+     Cycle Time Distribution               ┌───────────────────┐
+  ┌──────────────────────────┐            │████████████ 18    │ W1
+  │ 0-1h  ████████ 28%       │            │██████████   15    │ W2
+  │ 1-4h  ██████████████ 35% │            │████████████████ 22│ W3
+  │ 4-24h ████████ 22%       │            └───────────────────┘
+  │ 1-3d  ████ 10%           │
+  │ 3-7d  ██ 4%              │
+  │ 7d+   █ 1%               │
+  └──────────────────────────┘
+```
+
+---
+
+## Conclusion
+
+This plan transforms the default dashboard from a basic metrics display into an interactive, insight-rich analytics tool. By leveraging data we already collect and following a phased approach, we can deliver incremental value while building toward the comprehensive experience users expect.
+
+The key insight: **the data is ready; we just need to surface it effectively.**