potiuk opened a new pull request, #486: URL: https://github.com/apache/airflow-steward/pull/486
## What Makes `pr-management-stats` **always** publish its dashboard as a self-contained HTML page to a **secret GitHub gist**, returning the `gistpreview.github.io` URL — replacing the prior "render inline only" default. One canonical export, same shape every run, at a stable per-repo URL so a maintainer's dashboards are comparable day to day. Plus two analytic panels that came out of a long real triage+review+stats session on `apache/airflow`: - **Ready-for-review queue split (by why-waiting)** — breaks the bare "Ready = N" into **never-reviewed / discussed-no-decision / changes-requested / approved**, as coloured hero cards + an age timeline (oldest bucket on the left). It separates a *first-review gap* (nobody has looked) from a *decision/merge gap* (discussed/approved but stuck) — usually the single most useful reframe of a "review-bound" queue. - **Drafts & closes attribution by person** — who actually does the draft-conversions and closes, **triage-action (actor ≠ author) vs author-self**, with per-maintainer shares. Counted from `CONVERT_TO_DRAFT` / `CLOSED` **timeline events** (not comment text — which undercounts badly), with **bots and backport PRs excluded**. ## Why The skill produced great inline dashboards but they evaporated at end-of-session and weren't shareable. Always-publish + a stable URL makes them durable and comparable. The two new panels encode lessons that bit during real use: comment-text detection undercounts drafts/closes ~3–10×; bot/backport closes inflate "maintainer" attribution; and "review-bound" is two distinct gaps, not one. ## Changes - **new** `skills/pr-management-stats/export.md` — the always-publish-to-gist contract (stable gist id, in-place PATCH, dry-run / no-`gist`-scope fallbacks, mandatory 1000-result Search-cap data-integrity caveats). - **new** `tools/pr-management-stats/gen_charts.sh` — reusable inline-SVG line-chart helper (no external JS/CSS, GitHub-dark palette). - **new** `tools/pr-management-stats/examples/reference-dashboard.html` — a worked reference rendering (apache/airflow, illustrative numbers; the panel set + layout are the spec). - **edit** `SKILL.md` — adds **Step 7 — Publish (always)** and the two new required panels. - **edit** `render.md` — specs the two new panels. Follow-up (separate PR): extend the `dashboard.py` CI parity implementation to render the two new panels and the gist publish — kept out of this PR to keep the spec change reviewable. ##### Was generative AI tooling used to co-author this PR? - [X] Yes — Claude Code (Opus 4.8 1M context) Generated-by: Claude Code (Opus 4.8 1M context) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
