Skip to content

Conversation

@castrojo
Copy link
Contributor

Summary

This PR achieves two goals:

  1. Remove Aurora from monthly report monitoring - Aurora is a KDE-focused sister project and should not be included in Bluefin (GNOME) monthly reports
  2. Validate PR labeling effectiveness - Regenerate January 2026 report after manually labeling 53 historical PRs across 9 repositories

Changes

1. Remove Aurora Monitoring (scripts/lib/monitored-repos.mjs)

  • Removed "ublue-os/aurora" from MONITORED_REPOS array
  • Added explanatory comment about exclusion rationale
  • Impact: Removes 27 Aurora items from January 2026 report

2. Regenerate January 2026 Report (reports/2026-01-31-report.mdx)

  • Command: npm run generate-report -- --month=2026-01
  • Report now reflects all manual PR labeling completed in previous phases
  • Impact: All 53 previously unlabeled PRs now properly categorized

Results

Before This Work

  • Total items: 167
  • Items in "Other" section: 80 (27 Aurora + 53 unlabeled)
  • Properly categorized: 87 items (52%)

After This Work

  • Total items: 140 (-27 Aurora items)
  • Items in "Other" section: 0 (100% elimination)
  • Properly categorized: 140 items (100%)

Label Creation Summary

Created 15 new labels across 4 repositories to support categorization:

projectbluefin/documentation (8 labels)

  • area/iso - ISO/image builds
  • area/brew - Homebrew package management
  • area/dx - Developer experience tools
  • area/just - Justfile automation
  • area/services - Systemd services
  • kind/documentation - Documentation updates
  • kind/automation - CI/CD automation
  • kind/tech-debt - Technical debt

projectbluefin/iso (5 labels)

  • area/iso, area/brew, area/bling, area/buildstream, kind/automation

projectbluefin/branding (1 label)

  • area/iso

projectbluefin/egg (1 label)

  • area/buildstream

PRs Labeled

Manually labeled 53 PRs across 9 repositories using gh pr edit commands:

  • projectbluefin/documentation: 27 PRs
  • ublue-os/bluefin-lts: 8 PRs
  • projectbluefin/iso: 7 PRs
  • ublue-os/bluefin: 3 PRs
  • ublue-os/homebrew-experimental-tap: 3 PRs
  • projectbluefin/dakota: 2 PRs
  • projectbluefin/common: 1 PR
  • projectbluefin/branding: 1 PR
  • projectbluefin/egg: 1 PR

Validation

  • All 53 PRs successfully labeled
  • Report regenerated successfully
  • TypeScript compilation passes (npm run typecheck)
  • Build completes successfully (npm run build)
  • Changes committed to feature branch
  • Branch pushed to remote
  • Manual browser verification needed - Please test:
    1. Run npm run start
    2. Navigate to http://localhost:3000/reports/2026/01
    3. Verify "Other" section is absent
    4. Verify Infrastructure section includes ISO PRs
    5. Verify Documentation section includes docs PRs
    6. Verify categories are properly populated

Technical Notes

Why Remove Aurora?

Aurora is the KDE Plasma variant of Universal Blue. While it's a sister project, monthly reports should focus exclusively on the Bluefin (GNOME) ecosystem to avoid confusion and maintain clear scope.

Label System

The monthly report generator uses label-based categorization defined in scripts/lib/label-mapping.mjs:

  • area/ labels: Functional area (desktop, dx, brew, iso, etc.)
  • kind/ labels: Work type (documentation, tech-debt, automation, bug, etc.)

PRs without matching labels previously fell into the "Other" section.

One-Time Manual Operation

Labeling was done manually because:

  • One-time historical cleanup (not recurring)
  • AI-assisted analysis with human verification
  • More accurate than automated heuristics
  • gh CLI made bulk operations efficient

Future Considerations

Ongoing Label Maintenance

Future PRs should be labeled at creation time by maintainers. Consider:

  • PR templates with label checklists
  • Documentation in LABELS.md explaining available labels
  • CI enforcement requiring labels before merge

Historical Reports

December 2025 and earlier reports still contain "Other" sections. We chose not to regenerate them to focus on January 2026 forward.

Testing Instructions

# Clone and checkout
git checkout feature/remove-aurora-validate-labeling

# Install dependencies
npm install

# Run validation
npm run typecheck
npm run build

# Start dev server for manual testing
npm run start
# Then visit: http://localhost:3000/reports/2026/01

# Check report structure
grep "^## " reports/2026-01-31-report.mdx

Success Metrics

✅ 100% categorization rate (0 items in "Other")
✅ 53 PRs labeled across 9 repositories
✅ 15 new labels created
✅ 27 Aurora items excluded (proper scope)
✅ Build passes with no errors


Ready for review and manual browser verification.

Assisted-by: Claude Sonnet 4 via Replit Agent

Aurora is a KDE variant (sister project) and not Bluefin-focused.
Monthly reports should focus on Bluefin ecosystem only. Aurora
items will only appear if explicitly tracked in projectbluefin/common.

- Remove ublue-os/aurora from MONITORED_REPOS
- Add comment explaining exclusion policy

Assisted-by: Claude Sonnet 4 via OpenCode
After labeling 53 PRs across 9 repositories and removing Aurora from
monitoring, regenerate report to validate categorization.

Changes:
- Total items: 167 → 140 (Aurora removed: -27 items)
- Categorized items: 87 → 140 (labeling applied: +53 items)
- Other section: 80 → 0 items (100% categorization success)
- Contributors: 23 → 22 (Aurora contributor excluded)
- New contributors: 10 → 9 (Aurora new contributor excluded)
- Bot PRs: 304 → 233 (Aurora bot activity excluded)

Label creation summary:
- projectbluefin/documentation: 8 labels created
- projectbluefin/iso: 5 labels created
- projectbluefin/branding: 1 label created
- projectbluefin/egg: 1 label created

All 53 labeled PRs successfully categorized into appropriate sections:
- Infrastructure: +18 items (ISO, buildstream, testing)
- Documentation: +11 items (docs content)
- Automation: +12 items (CI/CD, workflows)
- Tech Debt: +8 items (cleanup, refactoring)
- Ecosystem: +4 items (homebrew, flatpak)

Assisted-by: Claude Sonnet 4 via OpenCode
Keep our version with Aurora removed (140 items, 22 contributors).
Removed 'Other' section that contained Aurora items from main branch.
- Pass displayedUrls Set to generateUncategorizedSection() to prevent items from appearing in both categorized sections and 'Other'
- Add URL checking in generateUncategorizedSection() before processing items
- Mark uncategorized items as displayed after adding to output
- Regenerate January 2026 report to ensure clean output without duplicates

This ensures items only appear once in monthly reports, even if they have multiple labels or edge cases occur.
@castrojo castrojo merged commit 26e86ed into main Jan 29, 2026
2 checks passed
@castrojo castrojo deleted the feature/remove-aurora-validate-labeling branch January 29, 2026 02:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants