Skip to content

feat(reports): add homebrew tap promotions section to monthly reports#614

Merged
castrojo merged 3 commits intomainfrom
feature/homebrew-tap-promotions
Feb 2, 2026
Merged

feat(reports): add homebrew tap promotions section to monthly reports#614
castrojo merged 3 commits intomainfrom
feature/homebrew-tap-promotions

Conversation

@castrojo
Copy link
Contributor

@castrojo castrojo commented Feb 2, 2026

Summary

Implements automated detection and reporting of packages promoted from experimental-tap to production-tap during the monthly reporting period.

Changes

  • New module: scripts/lib/tap-promotions.mjs - Fetches promoted packages via GitHub API
  • Report integration: Adds promotions section to monthly reports between Build Health and Contributors
  • Markdown generation: Formats promotions with package names, descriptions, PR links, and usage instructions

How It Works

  1. Queries merged PRs from production-tap (ublue-os/homebrew-tap) in report date range
  2. Identifies PRs that added new Formula/ or Casks/ files
  3. Extracts package descriptions from Ruby formula files
  4. Generates markdown section with promotion list and usage instructions

Validation

Tested with January 2026 report (--month=2026-01):

  • ✅ Successfully detected 3 promotions: goose-linux, antigravity-linux, linux-mcp-server
  • ✅ Descriptions accurately extracted from formula files
  • ✅ Usage instructions and tap link included
  • ✅ Section gracefully omits when no promotions occurred
  • ✅ TypeScript validation: 0 errors
  • ✅ ESLint validation: 0 errors (50 warnings - pre-existing)

Success Criteria (from bluefin-docs-itu)

  • Report generator detects promotions from experimental to production tap
  • Promotions section appears in monthly reports when promotions occurred
  • Package descriptions accurately extracted from formula files
  • Section omitted when no promotions
  • Usage instructions and tap link included
  • Test with January 2026 report (known promotions: antigravity, linux-mcp-server)

Example Output

## Homebrew Tap Promotions

The following packages graduated from experimental-tap to production-tap this month, ready for wider use:

- **goose-linux** - Open source, extensible AI agent ([#188](https://github.com/ublue-os/homebrew-tap/pull/188), Jan 2)
- **antigravity-linux** - AI Coding Agent IDE ([#199](https://github.com/ublue-os/homebrew-tap/pull/199), Jan 12)
- **linux-mcp-server** - MCP server for Linux system administration ([#221](https://github.com/ublue-os/homebrew-tap/pull/221), Jan 25)

Use \`ujust bbrew\` to browse and install these packages. Follow [the tap instructions](https://github.com/ublue-os/homebrew-tap) if you want to do it by hand.

Closes #bluefin-docs-itu

Implement automated detection and reporting of packages promoted from
experimental-tap to production-tap during the reporting period.

Changes:
- Add tap-promotions.mjs module to fetch promoted packages via GitHub API
- Extract package names, descriptions, and PR metadata from tap repos
- Generate formatted markdown section with promotion details
- Integrate into monthly report generator with graceful error handling
- Section auto-omits when no promotions occurred

Tested with January 2026 report:
- Successfully detected 3 promotions (goose-linux, antigravity-linux, linux-mcp-server)
- Descriptions accurately extracted from formula files
- Usage instructions and tap link included

Closes bluefin-docs-itu

Assisted-by: Claude Sonnet 4.5 via GitHub Copilot
Move the Homebrew Tap Promotions from a standalone section to a subsection
at the top of the Development > Homebrew area for better organization.

Changes:
- Tap promotions now appear as first subsection under Development
- Followed by Homebrew Package Updates subsection
- Remove standalone tap promotions section from end of report
- Create generateTapPromotionsContent() helper for content without heading
- Keep generateTapPromotionsSection() for backward compatibility

Structure now:
  ## Development
    ### Homebrew Tap Promotions (if any)
    ### Homebrew Package Updates (if any)

Assisted-by: Claude Sonnet 4.5 via GitHub Copilot
Create unified Homebrew section under Development with two subsections:
- Promotions: Packages graduated from experimental to production tap
- Package Updates: Automated version bump activity

This structure keeps related Homebrew content together while maintaining
clear separation between promotions (curated graduations) and routine
updates (automated version bumps).

Regenerated December 2025 and January 2026 reports to reflect new structure:
- December: 0 promotions (subsection omitted), 72 package updates
- January: 3 promotions (goose-linux, antigravity-linux, linux-mcp-server), 75 package updates

Assisted-by: Claude Sonnet 4.5 via GitHub Copilot
@castrojo castrojo merged commit 38f7f3d into main Feb 2, 2026
2 checks passed
@castrojo castrojo deleted the feature/homebrew-tap-promotions branch February 2, 2026 00:42
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.

1 participant