Skip to content

docs(release-skill): collapse notes by library identity and derive versions from project.yml - #256

Merged
OliverWolffGIP merged 1 commit into
mainfrom
chore/release-skill-collapse-rules
Sep 3, 2026
Merged

OliverWolffGIP merged 1 commit into
mainfrom
chore/release-skill-collapse-rules

Conversation

@OliverWolffGIP

Copy link
Copy Markdown
Collaborator

Aligns this repo's release skill with the fixes found while cutting a release in
nifi-extensions, where four dependency entries shipped duplicated in the notes.

Release-note grouping

The collapse rule keyed on PR-title equality, so titles differing only by a
directory or coordinate suffix matched nothing and both lines survived.

  • Collapse by library identity, spelling out the three shapes that occur: version
    chains, the same library bumped in several modules/directories, and one upstream
    release landing as several coordinates (e.g. a version property and a BOM/parent).
  • Recover versions the title omits — Dependabot truncates a title to
    bump <lib> in /<dir> when several deps must move together; the versions are then
    only in the PR body. No dependency line may ship without a version range.
  • Resolved a contradiction: the old rules required both rewriting the version range
    when collapsing and preserving each line verbatim. The collapse rules now explicitly win.
  • Added a mandatory duplicate check before gh release edit: every library must
    appear exactly once. This catches the above mechanically instead of by careful reading.

Versions derived from .github/project.yml

The skill restated current-version / next-version inline and built its examples
around that hardcoded pair, so every release made the skill stale. Both numbers are now
read from .github/project.yml, and the branch-name and project.yml-edit examples use
placeholders. The repo's own versioning policy is preserved, expressed symbolically.

Documentation-only change under .claude/.

🤖 Generated with Claude Code

https://claude.ai/code/session_01QDdBo9BsuMyifN5g6551v7

…rsions from project.yml

Aligns this repo's release skill with the fixes found while cutting a release in
nifi-extensions, where four dependency entries shipped duplicated in the notes.

## Release-note grouping

The collapse rule keyed on **PR-title equality**, so titles differing only by a
directory or coordinate suffix matched nothing and both lines survived.

- **Collapse by library identity**, spelling out the three shapes that occur: version
  chains, the same library bumped in several modules/directories, and one upstream
  release landing as several coordinates (e.g. a version property *and* a BOM/parent).
- **Recover versions the title omits** — Dependabot truncates a title to
  `bump <lib> in /<dir>` when several deps must move together; the versions are then
  only in the PR body. No dependency line may ship without a version range.
- **Resolved a contradiction**: the old rules required both rewriting the version range
  when collapsing and preserving each line verbatim. The collapse rules now explicitly win.
- **Added a mandatory duplicate check** before `gh release edit`: every library must
  appear exactly once. This catches the above mechanically instead of by careful reading.

## Versions derived from `.github/project.yml`

The skill restated `current-version` / `next-version` inline and built its examples
around that hardcoded pair, so every release made the skill stale. Both numbers are now
read from `.github/project.yml`, and the branch-name and `project.yml`-edit examples use
placeholders. The repo's own versioning policy is preserved, expressed symbolically.

Documentation-only change under `.claude/`.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QDdBo9BsuMyifN5g6551v7
@OliverWolffGIP OliverWolffGIP added the skip-bot-review Skip automated bot code review (Gemini/CodeRabbit/Sourcery) label Sep 3, 2026

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry @OliverWolffGIP, you've used your own review budget of 250,000 diff characters for the last 7 days.

You can request another review in 2 days and 13 hours by commenting @sourcery-ai review. Upgrade to get a review now.

@coderabbitai

coderabbitai Bot commented Sep 3, 2026 •

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are limited based on label configuration.

🚫 Review skipped — only excluded labels are configured. (1)
  • skip-bot-review

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository: cuioss/coderabbit/.coderabbit.yaml

Review profile: CHILL

Plan: Team

Run ID: 65fe28a6-cc1a-4677-b9cf-9e006692e16c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@OliverWolffGIP
OliverWolffGIP added this pull request to the merge queue Sep 3, 2026
Merged via the queue into main with commit 841058d Sep 3, 2026
21 checks passed
@OliverWolffGIP
OliverWolffGIP deleted the chore/release-skill-collapse-rules branch September 3, 2026 09:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

skip-bot-review Skip automated bot code review (Gemini/CodeRabbit/Sourcery)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants