demo-3-repo-pulse

name	demo-3-repo-pulse
description	Demo skill that pulls live GitHub API data for a repo, analyses a full year of weekly commit activity and top contributors, and renders a single-file dashboard.html with stat tiles and inline SVG charts — no chart library.

Build a repo pulse dashboard from live data: probe the GitHub API, pull a repository's last 52 weeks of activity, analyse it, and render everything into one self-contained .decode/outputs/dashboard.html the human can open in a browser. All files this demo produces live under .decode/outputs/ (unless the human named a different path).

Default target repository: pydantic/pydantic-ai. If the human named a different owner/repo, use that instead.

1. Probe the data source

Use web_fetch to look at the live API and learn the exact field names before writing any code:

• https://api.github.com/repos/pydantic/pydantic-ai — note stargazers_count, forks_count, open_issues_count, description.

That one probe is enough — do not fetch the big endpoints with web_fetch; the analysis script will pull those.

2. Write the analysis script

Write .decode/outputs/pulse.py and run it with the one dependency brought in just for the run (do NOT add project dependencies):

uv run --with requests python .decode/outputs/pulse.py

The script must:

1. GET these three endpoints (plain requests, no auth token needed):
   • https://api.github.com/repos/{owner}/{repo} — the headline stats.
   • https://api.github.com/repos/{owner}/{repo}/stats/commit_activity — the last 52 weeks of commit counts, one entry per week (total commits + a Unix week timestamp). The whole year arrives in this ONE request — never page through /commits for it.
   • https://api.github.com/repos/{owner}/{repo}/contributors?per_page=10 — top contributors with their commit counts.
2. The stats endpoint answers 202 while GitHub computes the data: retry a few times with a short sleep until it answers 200 with the 52-entry list.
3. Aggregate: commits per week across the 52 weeks (label each week with the ISO date of its week timestamp), the busiest week of the year, and the top-10 contributor leaderboard.
4. If the API answers 403 (rate limit), say so plainly; if GITHUB_TOKEN is set in the environment, send it as a Bearer header.

3. Render the dashboard — charts as inline SVG

Have the script generate .decode/outputs/dashboard.html — one file, zero external requests, no chart library. Draw both charts as inline <svg> elements built with Python string formatting (no image files, no JavaScript):

• A header with the repo name and description.
• Four stat tiles: ⭐ stars, 🍴 forks, 🐛 open issues, 👥 contributors shown.
• Commits per week — an SVG bar chart: one <rect> per week (52 bars), heights scaled to the busiest week, a handful of month labels along the x-axis, and a <title> tooltip per bar (YYYY-MM-DD — N commits).
• Top contributors — an SVG horizontal bar chart: one <rect> per contributor, with the login and commit count labelled as <text>.
• Simple clean CSS, dark background.

4. Verify and report

1. Sanity-check the HTML exists and carries both charts: grep -c "<svg" .decode/outputs/dashboard.html should print 2.
2. Tell the human to open it: open .decode/outputs/dashboard.html.

Report the headline numbers (stars, forks, open issues), the busiest week of the year, the top contributor, and the one-line command to open the dashboard.