Merge pull request #2 from RiveryIO/feat/ohad/generate-web-reports-skill

feat: auto-deploy password-protected dashboard to GitHub Pages

Author: OhadPerryBoomi

.claude/skills/generate-web-reports/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: generate-web-reports
+description: "Generates an interactive HTML dashboard from complexity-report.csv, serves it locally, and opens the browser. Produces tabbed ECharts with search, developer filtering, and 20+ chart types across basic, team, risk, fairness, and advanced categories. Use when the user asks to generate reports, view the dashboard, open the web report, visualize complexity data, or see engineering intelligence charts."
+---
+
+# Generate Web Reports
+
+Produces an interactive HTML dashboard (`reports/index.html`) with 20+ dynamic ECharts organized in tabs: Basic, Team, Risk, Fairness, Advanced. Includes global chart search and per-developer filtering.
+
+## Prerequisites
+
+- `complexity-report.csv` in project root (from `complexity-cli batch-analyze`)
+- Python packages: `pandas`, `numpy`, `matplotlib`
+- `teams.cfg` must exist for team-level charts
+
+## Workflow
+
+### Step 1: Ensure Data Exists
+
+If `complexity-report.csv` is missing or stale, generate it first:
+
+```bash
+complexity-cli batch-analyze --all-repos --days 30 -o complexity-report.csv --provider anthropic
+```
+
+### Step 2: Generate Reports
+
+```bash
+complexity-cli generate-reports -i complexity-report.csv -o reports
+```
+
+This runs all report functions in parallel (~10 seconds), produces PNG charts, a master composite, and the interactive `reports/index.html` dashboard.
+
+### Step 3: Serve & Open Browser
+
+```bash
+python -m http.server 8080 -d reports &
+open http://localhost:8080
+```
+
+On Linux use `xdg-open` instead of `open`.
+
+### Step 4: Stop Server When Done
+
+```bash
+# Find and kill the server
+lsof -ti:8080 | xargs kill 2>/dev/null
+```
+
+## What the Dashboard Shows
+
+| Tab | Charts |
+|-----|--------|
+| **Basic** | Velocity over time, velocity by month, PR count vs complexity, rolling avg complexity, merge cycle time, high-risk PR % |
+| **Team** | Complexity distribution (boxplot), Gini coefficient, velocity per team per dev, merge cycle by team, complexity vs cycle time, developer velocity (stacked bar), complexity vs PR count (scatter) |
+| **Risk** | Complexity by merge weekday, complexity distribution histogram |
+| **Fairness** | PR size vs complexity (correlation check), PR count vs avg complexity (anti-splitting) |
+| **Advanced** | Developer velocity by week (multi-line with picker), team velocity trend (rolling 4w), cumulative velocity |
+
+## Quick One-Liner
+
+```bash
+complexity-cli generate-reports && python -m http.server 8080 -d reports & sleep 1 && open http://localhost:8080
+```
+
+## Public Dashboard (Auto-Deploy)
+
+The dashboard is also deployed automatically to GitHub Pages on every push of `complexity-report.csv` to `main`.
+
+**URL:** `https://riveryio.github.io/complexity-analyzer/` (password-protected via StatiCrypt)
+
+To update the public dashboard:
+
+```bash
+git add complexity-report.csv
+git commit -m "data: update complexity report"
+git push
+```
+
+GitHub Actions generates reports and deploys a password-protected version. The workflow lives in `.github/workflows/deploy-reports.yml`.

.claude/skills/weekly-velocity-graph/SKILL.md

@@ -1,32 +1,18 @@
 ---
 name: weekly-velocity-graph
-description: Generates R&D velocity-by-week graph from complexity-report.csv. Use when the user asks for a weekly velocity chart, R&D velocity graph, or to visualize PR throughput by week.
+description: "DEPRECATED — use the generate-web-reports skill instead, which produces an interactive HTML dashboard with all charts (including velocity by week). This skill generated a static PNG bar chart and is no longer maintained."
 ---
 
-# Weekly Velocity Graph
+# Weekly Velocity Graph (DEPRECATED)
 
-Generates a two-panel bar chart showing R&D velocity by week: PRs merged per week and complexity-weighted velocity (sum of scores).
+**This skill is deprecated.** Use `generate-web-reports` instead, which produces an interactive HTML dashboard with tabbed charts, search, and developer filtering — including the velocity-by-week chart this skill used to generate.
 
-## Prerequisites
+```bash
+# Instead of this:
+# python scripts/velocity_by_week.py
 
-- `complexity-report.csv` in project root (from `complexity-cli batch-analyze`)
-- `matplotlib`: `pip install matplotlib`
-- `GH_TOKEN` or `gh auth token` (for fetching merge dates)
-
-## Workflow
-
-1. **Ensure data exists**: If `complexity-report.csv` is missing or stale, run:
-   ```bash
-   complexity-cli batch-analyze --all-repos --days 14 -o complexity-report.csv --provider anthropic
-   ```
-
-2. **Generate the graph**:
-   ```bash
-   python scripts/velocity_by_week.py
-   ```
-
-3. **Output**: `velocity-by-week.png` in project root
-
-## Optional: Custom CSV path
-
-The script reads `complexity-report.csv` from the project root. To use a different file, pass it via env or modify the script's `csv_path` variable.
+# Use:
+complexity-cli generate-reports -i complexity-report.csv -o reports
+python -m http.server 8080 -d reports &
+open http://localhost:8080
+```

.github/workflows/deploy-reports.yml

@@ -0,0 +1,54 @@
+name: Deploy Reports
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - complexity-report.csv
+      - reports/**/*.py
+      - cli/**/*.py
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Install Python dependencies
+        run: pip install -e .
+
+      - name: Generate reports
+        run: python -m cli.main generate-reports -i complexity-report.csv -o _site
+
+      - name: Password-protect dashboard
+        run: npx staticrypt@3 _site/index.html -p "${{ secrets.DASHBOARD_PASSWORD }}" --short --remember 30 -o _site/index.html
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: _site
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -50,6 +50,7 @@ Thumbs.db
 
 # Results/data files
 *.csv
+!complexity-report.csv
 *.png
 results/