/release-app

name: release-app
description: アプリのリリース（バージョンbump + CHANGELOG + タグ → GH Actions で自動ビルド・配布）。iOS / Android / macOS / Linux / Windows の任意の組み合わせでリリースできる。「リリース」「バージョン上げて」「リリースして」と言われたときに使う。
disable-model-invocation: true
allowed-tools: Bash(git:*), Bash(grep:*), Bash(gh:*), Bash(jq:*), Bash(dart analyze:*), Bash(cd apps/mobile && flutter test), Read, Edit, AskUserQuestion

アプリ リリース

Flutter アプリのリリースを行う。 タグ push 後は GH Actions が自動でビルド・署名・配布・GitHub Release を作成する。

前提

• main ブランチで作業中であること
• 未コミットの変更がないこと

手順

1. 現在のバージョン確認 & 変更内容の収集

grep '^version:' apps/mobile/pubspec.yaml

`version: X.Y.Z+N` の形式。`+N` は build number。

前回リリースからの差分を確認する:

# 前回のタグ（iOS/Android/macOS/Linux/Windows のいずれか新しい方）
git tag -l 'ios/v*' 'android/v*' 'macos/v*' 'linux/v*' 'windows/v*' --sort=-v:refname | head -1

# 差分コミット（bridge 以外）
git log $(git tag -l 'ios/v*' 'android/v*' 'macos/v*' 'linux/v*' 'windows/v*' --sort=-v:refname | head -1)..HEAD --oneline -- apps/mobile/ CHANGELOG.md

2. バージョンとプラットフォームをユーザーに確認

差分コミットの内容を分析し、AskUserQuestion で **2つの質問を同時に** 確認する。

質問 1: バージョン

**選択肢の決定ルール:**

• `feat` コミットがある → **minor** を推奨（1番目の選択肢にし「(Recommended)」を付ける）
• `feat` がなく `fix` のみ → **patch** を推奨
• 破壊的変更がある → **major** を推奨

選択肢は具体的なバージョン番号で提示する（例: 「1.20.0+43 (minor)」「1.19.1+43 (patch)」）。 build number は現在の値 +1 で統一する。

質問 2: プラットフォーム

以下の選択肢を提示する:

• **iOS + Android + macOS + Linux + Windows 全部** (Recommended)
• **iOS + Android のみ**（モバイルのみ）
• **macOS + Linux + Windows のみ**（デスクトップのみ）
• **macOS のみ**
• **Linux のみ**
• **Windows のみ**
• **iOS のみ**
• **Android のみ**

3. CHANGELOG 更新

`CHANGELOG.md`（ルート）の先頭に新しいセクションを追加する。

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

### Added
- ...

### Changed
- ...

### Fixed
- ...

ステップ 1 で確認したコミットを元に、Added / Changed / Fixed に分類する。 空のセクション（該当なし）は省略する。

4. バージョン bump

`apps/mobile/pubspec.yaml` の `version` をステップ 2 で決定したバージョンに更新する。

5. ローカル検証

タグ push 前に、CD と同じチェックをローカルで実行する。 **すべて pass しなければ次のステップに進まない。**

# 静的解析
dart analyze apps/mobile

# テスト
cd apps/mobile && flutter test

失敗した場合はユーザーに報告し、修正を待つ。

6. コミット & タグ

git add apps/mobile/pubspec.yaml CHANGELOG.md
git commit -m "chore: bump version to X.Y.Z+N"
git push origin main

ステップ 2 で選択されたプラットフォームのタグを打つ:

# iOS（選択された場合）
git tag ios/vX.Y.Z+N
git push origin ios/vX.Y.Z+N

# Android（選択された場合）
git tag android/vX.Y.Z+N
git push origin android/vX.Y.Z+N

# macOS（選択された場合）
git tag macos/vX.Y.Z+N
git push origin macos/vX.Y.Z+N

# Linux（選択された場合）
git tag linux/vX.Y.Z+N
git push origin linux/vX.Y.Z+N

# Windows（選択された場合）
git tag windows/vX.Y.Z+N
git push origin windows/vX.Y.Z+N

7. 完了確認

タグ push 後、GH Actions が自動実行される:

| タグ | ワークフロー | 内容 | |-----|------------|------| | `ios/v*` | `ios-release.yml` | Shorebird release iOS → TestFlight → GitHub Release | | `android/v*` | `android-release.yml` | Shorebird release Android → Google Play (internal draft) → GitHub Release | | `macos/v*` | `macos-release.yml` | Developer ID 署名 → 公証 → DMG → GitHub Release | | `linux/v*` | `linux-release.yml` | Linux release build → Xvfb smoke → tar.gz → GitHub Release | | `windows/v*` | `windows-release.yml` | Windows release build → smoke → zip → GitHub Release |

# 各プラットフォームのワークフロー確認（タグを打ったもののみ）
gh run list --workflow=ios-release.yml --limit 1
gh run list --workflow=android-release.yml --limit 1
gh run list --workflow=macos-release.yml --limit 1
gh run list --workflow=linux-release.yml --limit 1
gh run list --workflow=windows-release.yml --limit 1

選択した全プラットフォームの CD が `completed/success` になるまで確認を継続する。 失敗した場合は `gh run view <run-id> --log-failed` で原因を確認し、修正後に再実行する。

待機の目安

リリース CD は Shorebird release、署名、公証、ストア配布を含むため、通常 15 分前後かかる。 タグ push 直後から `gh run watch` で張り付くと出力が大きくなりやすいので、効率よく待つ場合は低頻度ポーリングにする。

推奨:

# 起動確認
gh run list --workflow=ios-release.yml --limit 1
gh run list --workflow=android-release.yml --limit 1
gh run list --workflow=macos-release.yml --limit 1
gh run list --workflow=linux-release.yml --limit 1
gh run list --workflow=windows-release.yml --limit 1

# 10〜15分ほど待ってから再確認
gh run list --workflow=ios-release.yml --limit 1
gh run list --workflow=android-release.yml --limit 1
gh run list --workflow=macos-release.yml --limit 1
gh run list --workflow=linux-release.yml --limit 1
gh run list --workflow=windows-release.yml --limit 1

途中確認する場合も 2〜3 分間隔を目安にする。`failure` / `cancelled` が出た場合だけ `gh run view <run-id> --log-failed` で詳細を確認する。

CD 成功までのポーリング

タグを打った workflow だけを対象に、成功するまでループする。以下の例では全プラットフォームを確認するが、実行していない workflow は `release_tags` から外す。

version="X.Y.Z+N"
declare -A release_tags=(
  [ios-release.yml]="ios/v${version}"
  [android-release.yml]="android/v${version}"
  [macos-release.yml]="macos/v${version}"
  [linux-release.yml]="linux/v${version}"
  [windows-release.yml]="windows/v${version}"
)

while true; do
  all_success=true
  for workflow in "${!release_tags[@]}"; do
    tag="${release_tags[$workflow]}"
    run_json=$(gh run list --workflow="$workflow" --branch="$tag" --limit 1 --json databaseId,status,conclusion,url)
    status=$(echo "$run_json" | jq -r '.[0].status')
    conclusion=$(echo "$run_json" | jq -r '.[0].conclusion')
    run_id=$(echo "$run_json" | jq -r '.[0].databaseId')
    url=$(echo "$run_json" | jq -r '.[0].url')

    echo "$workflow ($tag): $status/$conclusion $url"

    if [ "$status" = "completed" ] && [ "$conclusion" = "success" ]; then
      continue
    fi

    all_success=false
    if [ "$status" = "completed" ]; then
      gh run view "$run_id" --log-failed
      exit 1
    fi
  done

  if [ "$all_success" = true ]; then
    echo "All selected release workflows completed successfully."
    break
  fi

  sleep 180
done