gimbal-release

Gimbal の開発とリリース

作業範囲、レビュー、完了条件については、リポジトリの AGENTS.md と docs/definition-of-done.md に従ってください。実行可能なチェックと公開手順の 基準は Justfile と .github/workflows/ です。このスキルでは、どの手順を使うかを説明します。

迅速なフィードバック

編集のサイクルには just dev を使用します。マージを提案する前に、影響を受ける テストを実行し、要求された動作を確認してください。コミットフックでは、ステージ済みファイルのチェックと 小規模なキャッシュなしの単体テスト一式が実行されます。目標は 1 秒、上限は 3 秒です。 上限を超えると警告が表示され、未完了のチェックが記録されますが、出荷は妨げられません。 実際に正しさに関わる失敗には引き続き対応が必要です。just warm-hook は コミット処理の外でコンパイラーキャッシュを準備します。ジェネレーター、インストール、 リポジトリ全体の解析、ブラウザービルドはフックの対象外です。

PR の CI では、変更されたファイルに応じてチェックが選択されます。ドキュメントには 手順・リンクのチェック、自動化にはスクリプト・フックのチェック、アプリケーションの変更には 影響を受ける単体テストが実行されます。配布前には、main でアプリケーション全体のゲートを 1 回通過します。コミットした、PR がマージされた、タグが作成されたという理由だけで、 変更のないチェックを繰り返さないでください。既存の証拠には、その出所を明記し、 主張を裏付ける内容を含めてください。新たな失敗や入力の変更があれば、該当するチェックを 再実行してください。

ネイティブ UI を変更した場合は、使い捨てのカタログを使って実際のアプリと macOS の システムメニューバーを確認してください。~/.gimbal/desktop は決して使用しないでください。 要求されたスクリーンショットは gimbal upload-artifact でアップロードしてください。 ビルドや HTTP レスポンスだけでは、画面上の表示を証明できません。ソースビルドと アプリのライフサイクルについては development.md を、 カタログの更新についてのみ model-catalog.md を読んでください。

自動配布

ユーザーの承認範囲内でマージし、main から Release の実行に進む Automatic release の手順に従ってください。ドキュメントのみの変更を除き、変更は main で 1 回チェックされ、タグ付けされ、対応プラットフォーム向けにビルドされ、署名・公証されたうえで、アップデーターフィードと Homebrew tap に公開されます。ドキュメントのみの変更ではアプリはリリースされません。公開されたバージョンとチャンネルを確認してください。PR のマージや実行のキュー登録は、配布が完了したことを意味しません。マージ後やタグ作成後にローカルビルドを追加するのではなく、パイプラインで同一ソースに対して実施済みのチェックを再利用してください。

所要時間の方針は scripts/release-performance.json にあります。main から公開までの目標は 5 分、上限は 10 分です。キュー待ちや再試行の時間も含まれます。並列ジョブの時間を合算せず、各ステージの実行時間も報告されます。Release performance は実行状況を監視し、超過時にイシューを作成します。アプリケーションのテストを失敗させたり、公開を停止したりはしません。レポートを使って遅いステージを改善してください。レポートを緑にするためだけに予算を緩和しないでください。

公開に失敗した場合は、失敗したタグ付き Release ジョブを再実行するか、main で Automatic release を実行し、既存のタグを再利用してください。再試行する前に失敗したステージを確認し、成功済みのアプリケーションチェックを繰り返さないようにしてください。認証情報、ルール、手動でのメジャー／マイナータグ作成、署名の復旧、プラグインの互換性については distribution.md を読んでください。通常の配布で、新たな認証情報や権限の変更は必要ありません。

要求されたローカルインストール

公開 Homebrew cask（gimbal と gimbal-app）を使い、インストール済みバージョンと実際の実行ファイル／アプリのパスを確認してください。単独の go install では、ビルド済みの Web コンソールが含まれません。影響を受ける公開済みスキルは、関連するリファレンスとともに更新し、保守されているソースと比較してください。要求された場合は、ローカルインストールと実行時の動作確認が必要です。すべてのマージで追加の手順として行うものではありません。

確認できた要求動作、ソースのリビジョン、関連するチェック、公開状況、未解決の検証不足を報告してください。ソースでの確認、配布物での確認、インストール済み UI での確認を区別してください。署名や認証情報の詳細は通常の手順に転記せず、配布リファレンスに記載してください。