release

Release Workflow

LLM主導でバージョン更新とリリースコミットを作成し、ワークフローでタグ・Release・配布を完了する。

Preflight

• gh auth status が成功すること
• git status --short が空であること
• origin/develop を最新化できること

フロー

release (/release) 実行
    ↓
① origin/develop を pull してローカルを最新化
    ↓
② バージョン更新（Cargo.toml, CHANGELOG.md）
    ↓
③ chore(release): vX.Y.Z コミット作成
    ↓
④ Closing Issue を収集
    ↓
⑤ develop → main マージ（PR本文に Closing Issues 記載）
    ↓
⑥ release.yml がタグ作成 → GitHub Release作成
    ↓
⑦ publish.yml がバイナリビルド → Release にアタッチ

手順

0. ローカルを最新化（必須）

git fetch origin
git pull origin develop

1. バージョン更新

[workspace.package]
version = "X.Y.Z"

2. CHANGELOG.md 更新

## [X.Y.Z] - YYYY-MM-DD

### Added
- 新機能の説明

### Fixed
- バグ修正の説明

3. リリースコミット作成

git add Cargo.toml Cargo.lock CHANGELOG.md
git commit -m "chore(release): vX.Y.Z"
git push origin develop

4. Closing Issue の収集

1. 前回タグ〜HEADのコミットからPR番号抽出

LAST_TAG=$(git describe --tags --abbrev=0)
PR_NUMBERS=$(git log ${LAST_TAG}..HEAD --oneline \
  | grep -oE '(#[0-9]+)|\bMerge pull request #[0-9]+' \
  | grep -oE '[0-9]+' | sort -u)

1. 各PR本文から closing keyword 抽出

CLOSING_ISSUES=""
for pr in $PR_NUMBERS; do
  BODY=$(gh pr view "$pr" --json body -q '.body' 2>/dev/null || true)
  ISSUES=$(echo "$BODY" \
    | grep -oiE '(close[sd]?|fix(e[sd])?|resolve[sd]?)\s+#[0-9]+' \
    | grep -oE '[0-9]+' || true)
  CLOSING_ISSUES="$CLOSING_ISSUES $ISSUES"
done
CLOSING_ISSUES=$(echo "$CLOSING_ISSUES" | tr ' ' '\n' | sort -u | grep -v '^$')

1. PR番号を除外してIssueのみ残す

REAL_ISSUES=""
for num in $CLOSING_ISSUES; do
  IS_PR=$(gh api "repos/{owner}/{repo}/issues/$num" \
    --jq 'has("pull_request") and .pull_request != null' 2>/dev/null || echo "false")
  if [ "$IS_PR" = "false" ]; then
    REAL_ISSUES="$REAL_ISSUES $num"
  fi
done

1. PR本文用に出力

for num in $REAL_ISSUES; do
  echo "Closes #$num"
done

5. main へマージ

# 推奨: 既存スクリプト経由
./scripts/prepare-release.sh

# または prepare-release workflow を直接起動
gh workflow run prepare-release.yml

# 手動PR作成の場合
gh pr create --base main --head develop \
  --title "chore(release): vX.Y.Z"

6. 配布確認

• gh release view vX.Y.Z
• gh run list --workflow=publish.yml --limit 3
• GitHub Releases

注意

• バージョンは Semantic Versioning に従う
• chore(release): プレフィックスは必須（release.yml のトリガー条件）
• gh auth login 済みであること