ribir-bot

Unified CLI for PR, changelog, and release automation for the Ribir project.

Features

• PR Automation: AI-powered PR body generation (summary + changelog entries)
• Changelog Management: Collect, merge, and verify changelog entries using AST parsing
• Release Automation: Full release workflow with one command - changelog, cargo workspace, GitHub Release

Installation

cargo install --path .

Dependencies

• GitHub CLI (gh) - for GitHub operations
• Gemini CLI (gemini) - for AI generation
• cargo-edit - for version management

Usage

ribir-bot <COMMAND> [OPTIONS]

PR Commands

Update PR body with AI-generated content:

Examples:

ribir-bot pr fill              # Auto-fill current PR
ribir-bot pr regen 123         # Regenerate PR #123
ribir-bot pr summary --context "be concise"  # Regenerate with context

Changelog Commands

Update CHANGELOG.md:

Examples:

ribir-bot log collect --version 0.5.0          # Collect PRs for 0.5.0
ribir-bot log merge --version 0.5.0 --write    # Merge and write changes
ribir-bot log verify                           # Verify parsing

Release Commands

ribir-bot release <SUBCOMMAND> [OPTIONS]

Release Levels for next

Examples:

# Preview release (default is dry-run)
ribir-bot release next alpha

# Execute release
ribir-bot release next alpha --execute

# Enter RC phase (creates branch, PR, and publishes RC.1)
ribir-bot release enter-rc --version 0.5.0

# Release stable version (auto-detect from release branch)
ribir-bot release stable --execute

# Release stable version (explicit version)
ribir-bot release stable --version 0.5.0 --execute

# Verify release state
ribir-bot release verify

Global Options

Architecture

src/
├── main.rs       # Entry point and command dispatch
├── cli.rs        # Argument parsing and help text
├── types.rs      # Shared data types
├── utils.rs      # Utility functions
├── external.rs   # Gemini AI and GitHub CLI integration
├── changelog.rs  # Changelog AST parsing and manipulation
└── commands/
    ├── pr.rs        # PR body generation
    ├── changelog.rs # Changelog collection/merge/verify
    └── release.rs   # Release preparation and publishing

How It Works

PR Commands

1. Fetches PR data via gh pr view
2. Detects placeholders in PR body (marked with HTML comments)
3. Calls Gemini AI to generate summary and changelog entries
4. Updates PR body via gh pr edit

Changelog Commands

1. Parses CHANGELOG.md as an AST using comrak
2. Collects merged PRs via gh pr list
3. Extracts changelog entries from PR bodies or titles
4. Inserts entries into the appropriate version section
5. Renders AST back to markdown

Release Commands

release next <level> - One Command, Done

The unified release workflow:

1. Get version: Runs cargo set-version <level> --dry-run logic (internal) to determine next version
2. Collect changelog: Gathers entries from merged PRs into CHANGELOG.md
3. Cargo workspace: Bumps versions using cargo set-version, commits, tags, and publishes to crates.io
4. GitHub Release: Creates release with notes from changelog

Dry-run mode (default): Shows what would happen, including changelog and release notes preview.

Execute mode (--execute): Performs all operations.

Other Commands

• enter-rc: Creates release branch, archives old changelog, merges alpha entries, generates AI highlights, creates PR, and publishes RC.1
• publish: Creates GitHub release with release notes from changelog
• stable: Merges RC versions (if multiple), updates changelog, publishes to crates.io, creates stable GitHub release, and merges the preparation PR to master

Conventional Commit Types

The bot recognizes these types in PR titles and changelog entries:

License

Same license as the Ribir project.