release-notes

name	release-notes
description	Draft release notes for a new minor version
argument-hint	<new-version>

Draft release notes for a new Kargo minor release.

Argument: $0 = new version (e.g. 1.10.0). The previous minor is inferred automatically (e.g. 1.9).

Setup

Create a working directory for intermediate files:

mkdir -p /tmp/kargo-rn/metadata

Phase 1 -- Determine the commit range

1. Parse $0 to derive:

   • NEW_MINOR = major.minor (e.g. 1.10)
   • PREV_MINOR = the previous minor (e.g. 1.9)

2. Ensure local branches are up to date with upstream:

   git fetch upstream
   

   For each branch needed (release-$NEW_MINOR if it exists on upstream, otherwise main; and release-$PREV_MINOR):

   • If the local branch already exists, check it out and pull:

     git checkout <branch> && git pull upstream <branch>
     

   • If it doesn't exist locally, create it from upstream:

     git checkout -b <branch> upstream/<branch>
     

   The tip is if it exists, otherwise . The is the merge-base of the tip with . Collect the full commit list: