release

name	release
description	このリポジトリの検証とリリースの手順。作業中にどこまでテストを回すか、リリース前の全量ゲート、生成のバイト一致比較をいつやるか、バージョンを上げて GitHub Release を作るまでを出す。make release / make bump を打つとき、バージョンを上げるとき、「リリースしたい」「公開して」と言われたとき、全部のテストを回すか迷ったときに使う。
allowed-tools	Read, Grep, Glob, Bash

検証とリリース

作業中のループ（毎回やる）

テストは絞って速く回す。全量の検証はリリース直前の 1 回だけ。

• 変更が波及したパッケージだけ make test-<name>
• それ以外は flix check（コンパイル通過）で足りる
• テストを持たないパッケージ（templates 等）は常に check のみ

生成のバイト一致比較

「挙動を変えていない」と主張するリファクタの時だけやる。機能追加リリースでは不要。

gallery/ は git 管理外なので git status では見えない。 生成した絵の一致は make reference-check の SHA 突き合わせで見る。

1. ルートの make render-par（不審なら逐次の make render-all）。どちらも各テンプレで 全量の make render-all を打つ。テンプレ 1 本だけ確かめたいときは make -C templates/<name> render-all（make render SHOT=<場面名> は 1 枚だけなので リリースの全量ゲートには使わない）
2. git status で assets/sfx の差分ゼロを確認（音や素材の退行はここに出る）
3. for d in templates/*/; do make -C "$d" bench; done で全テンプレの絵が基準と一致するか確認
4. 基準を持たない絵は、生成し直した gallery/ を自分で目視する （.claude/skills/critique-render の手順）

bin/fge images も併せて通す（生成した絵が git に紛れ込んでいないか）。

リリース手順

このチェックリストを回答にコピーし、埋めながら進める。

- [ ] 1. engine ソースが全てコミット済み（未コミットなら make release が中断する）
- [ ] 2. make bump FROM=x TO=y
- [ ] 3. コミット / push（push を忘れると gh が明示エラーを出す）
- [ ] 4. make release
- [ ] 5. lib/ を消したコピーで外部 fetch 検証

make release は sync → test-par（全量ゲート）→ gl-parity → build-pkg → bundle-zip → gh release create を一括で回す。tag は現在の HEAD SHA に固定される。Release には fpkg・toml と一緒に同梱用 zip も上がる。

make bundle-zip（単体でも打てる）は Studio に同梱する engine 一式（bin/fge stage-engine）を flix_game_engine-engine-v<バージョン>.zip に固める。中身の一覧は bin/lint-rules/stage-engine.json が source of truth で、組み立てた後に check-refs --bundle 相当の 照合まで通る。lwjgl（Maven）の種は入っていない（Studio 側が自分の server/lib から渡す）。

こけやすいゲート（特にエンジン拡張のあと）

コミットや make release で止まる原因は毎回だいたい同じ。打つ前にここを潰す:

• precommit ゲート: コミットの瞬間に bin/fge precommit が走る。何で止まるかは bin/fge precommit --files <ステージ予定のファイル…> でコミット前に素振りできる。 よく引っかかるのは ①pub 宣言・doc コメントを触ったのに docs/api-digest.md が古い （make api-digest で作り直してから一緒にステージ）②docs / skills を触った時の make check-docs-sync（AGENTS.md と agents-pack の sync 印ずれ・切れたリンク） ③bin/fge jargon の独自語
• jargon は bin/fge jargon <触ったパス…> で素振りする（コミットコマンドを 人へ渡す前に自分で通す）。precommit 経由は git diff --cached を読むので、git add の 後に直しても同じ指摘が出続ける
• sync の出し忘れ: engine / engine_world / engine_tools のソースを触ったら対応する make sync-<name> を通してからテストする。古い fpkg のまま緑になっても信用できない
• lint 群は先に手で回す: フック任せにせず make lint-view lint-palette lint-ui lint-audio を リリース前に一巡させる。既知の赤が残ったままだとゲートで止まる
• make test-par の偽 FAIL: ログが依存解決で途切れテスト 0 本なら並列の食い合い。 当該パッケージを単体 make test-<name> で確かめ、必要なら make release TEST=test（逐次）
• make release は未コミットで中断する: gallery/ や NOTES.md は git 管理外なので git status に出ない＝残っていても邪魔しない。出ている差分だけ全部コミットする

全量ゲートは make test-par（全パッケージ並列・実時間 ≈ 最遅パッケージ 1 本分・ログは .test-logs/）。 併せて make gl-parity を回して A 段階の全一致（全 scene 0 px）を確認する（GL と SoftRaster の絵の退行はテストに出ない）。 並列版に不審な挙動があれば逐次へフォールバックする（make test / make release TEST=test）。