ai-dial-core: Command for Claude Code

Create a release patch

Arguments: $ARGUMENTS — first the release branch (e.g. release-0.9), then one or more merged PR numbers (e.g. 2060 2067).

development uses squash merges (<title> (#N)), so one PR is exactly one commit.

Preconditions

• Abort if fewer than 2 arguments are given.
• Abort if the working tree is dirty (git status --porcelain --untracked-files=no is not empty); untracked files are ignored.
• git fetch origin --tags, then verify origin/{release} exists. If not, list available origin/release-* branches and stop.

Steps

1. Check out and update the release branch:

   git checkout {release}
   git pull origin {release}
   

2. Resolve commits for all PRs up front. For each PR number {n}:

   • gh pr view {n} --json state,mergeCommit — use mergeCommit.oid when state is MERGED.
   • If that fails, fall back to git log origin/development --format=%H --grep='(#{n})'.
   • If the PR is not merged or no commit is found, stop and report.

   Sort the commits by merge order on origin/development (oldest first, e.g. git rev-list --reverse origin/development filtered to the resolved SHAs), regardless of argument order. Print the final PR → SHA order before continuing.

3. Create the patch branch. Compute {next_release_version}: take git describe --tags --abbrev=0 origin/{release} (e.g. 0.9.2) and increment the patch number (0.9.3). If no tag is found, ask the human. A previous aborted run or an open patch PR leaves the tag unchanged, so first check that the name is free locally (git rev-parse --verify --quiet patch-{next_release_version}) and on origin (git ls-remote --exit-code --heads origin patch-{next_release_version}). If either exists, ask the human whether to delete it or use a suffix (patch-{next_release_version}-2); never overwrite it. Then:

   git checkout -b patch-{next_release_version}
   

   Never push to the release branch directly.

4. Cherry-pick each commit in order:

   git cherry-pick -x {sha}
   

   -x appends a (cherry picked from commit ...) trailer; keep the original message.