feat(reports): split monthly reports into planned vs opportunistic work

[castrojo]

Summary

Split monthly reports into 📋 Planned Work (tracked on project board) and ⚡ Opportunistic Work (fixed directly in monitored repos) to provide a complete picture of all project activity.

Motivation

Previously, monthly reports only showed items tracked on the project board (todo.projectbluefin.io). This missed the significant amount of work happening organically across repositories—quick fixes, drive-by improvements, and community contributions that go straight to PRs without formal tracking.

This change surfaces all work happening across the Bluefin ecosystem.

Changes

New Features

• ✅ Fetch closed issues/PRs from 10 monitored repositories
• ✅ Compare with project board to identify opportunistic work
• ✅ Split each category into 📋 Planned and ⚡ Opportunistic subsections
• ✅ Deduplicate items across categories (show once in most relevant section)
• ✅ Filter contributors to PR authors only (not issue reporters)
• ✅ Filter out AI bots (copilot-swe-agent, dependabot, renovate, etc.)

Files Modified

• scripts/lib/monitored-repos.js - NEW: Configuration of 10 monitored repos
• scripts/lib/graphql-queries.js - Added repo-level closed items query
• scripts/generate-report.js - Fetches and separates planned vs opportunistic
• scripts/lib/markdown-generator.js - Generates split subsections with deduplication
• scripts/lib/contributor-tracker.js - Added copilot-swe-agent to bot filters
• reports/2025-12-31-report.mdx - Regenerated with new format

Monitored Repositories

1. ublue-os/bluefin
2. ublue-os/bluefin-lts
3. ublue-os/aurora
4. projectbluefin/common
5. projectbluefin/documentation
6. projectbluefin/branding
7. projectbluefin/iso
8. projectbluefin/dakota
9. ublue-os/distroless
10. projectbluefin/workshops

Impact

December 2025 Report

• Total items: 187 (8 planned + 179 opportunistic)
• Contributors: 21 PR authors (bots excluded)
• Shows reality: Most work happens organically, not formally tracked

Report Structure

Each Focus Area and Work Type category now has:

## 🖥️ Desktop Environment

### 📋 Planned Work
- Items from project board with "desktop" label

### ⚡ Opportunistic Work
- PRs/issues closed in monitored repos with "desktop" label
- Not tracked on project board

Technical Decisions

1. Deduplication Logic

   • Items with multiple labels appear only once (first matching category)
   • Prevents same PR from appearing under both "Desktop" and "Bug" sections
   • Uses Set to track displayed URLs across all sections

2. Contributors = PR Authors Only

   • Changed from all issue/PR participants to merged PR authors only
   • More accurately reflects code contributors vs issue reporters
   • Reduced December count: 54 → 21 (much more realistic)

3. Bot Filtering

   • Filters human vs bot activity separately
   • Bot section shows automated maintenance work
   • Human sections show only people contributions

4. GraphQL Item Type Detection

   • Added __typename field to opportunistic items
   • Enables proper filtering between Issues and PullRequests
   • Matches project board item structure

Testing

✅ Build validated: npm run build completes successfully
✅ Dev server tested: Report renders correctly at http://localhost:3000/reports
✅ December regenerated: 187 total items, 21 contributors, no duplicates
✅ Deduplication verified: Items appear only once across all categories
✅ Bot filtering verified: copilot-swe-agent excluded from human contributors

Preview

You can test this locally:

# Regenerate December report
GH_TOKEN=$(gh auth token) npm run generate-report

# Start dev server
npm start

# View report
open http://localhost:3000/reports/2025/12/31/report

Known Limitations

1. No pagination - Repos with >100 closed items/month will be truncated
2. No caching - Fetches fresh from all 10 repos every time (~5-7s)
3. January not regenerated - Still uses old single-section format

These can be addressed in future PRs if needed.

Follow-up Tasks

• Regenerate January 2026 report with new format
• Consider adding pagination for high-activity repos
• Consider caching closed items (24h TTL like other fetchers)

Related

• Implements transparency goals from project mission
• Complements existing contributor tracking system
• Works with label-based categorization (Desktop, Dev, Ecosystem, etc.)

---

Ready for review! This is a significant enhancement to the monthly report system that surfaces all work happening across the Bluefin project, not just formally tracked items.