merge-check

マージ前チェック: PR #$ARGUMENTS が gh pr merge 可能な状態か、docs/governance.md § 「PR レビューとマージ」>「マージ前チェックリスト」(SSoT) の全項目を実コマンドで検証して判定する。

このスキルは gh pr merge を実行する 直前 に呼び出すことを想定している。抽象的な確認でなく、以下の検証コマンドを実際に実行して MERGE_OK / BLOCKED の判定まで行う。詳細な背景・pagination の落とし穴・disposition ルールの正は docs/governance.md にあり、本コマンドは実行手順の具体化のみを担う。

検証手順

Step 1. CI green の確認

gh pr checks $ARGUMENTS --json name,bucket,startedAt --jq 'group_by(.name) | map(if any(.[]; .bucket == "pending") then (map(select(.bucket == "pending")) | first) else max_by(.startedAt) end) | .[] | select(.bucket != "skipping")'

• 全チェックが pass バケットであることを確認する（skipping は除外可）
• group_by(.name) 以降は同名 check のうち pending があればそれを、無ければ startedAt が最新の run を残す。queued の run は startedAt がゼロ時刻（0001-01-01T00:00:00Z）で並ぶため、max_by だけでは古い cancel / pass を最新と誤って採り、pending を隠す。gh pr checks は同じ head に対する全 run（concurrency で cancel された古い run を含む）を並べるため、これが無いと再実行済みの cancel を fail と読む（2026-09-04..05 に 3 回発生）
• pending が残る場合はマージせず、完了まで待ってから再実行する
• fail がある場合はマージ不可。pre-existing の main 失敗でも本 PR を直接マージせず、先に main を green に戻す（governance.md § 1 参照）

Step 2. レビュアーコメントの全件列挙と disposition 確認

2 つのエンドポイントを両方実行する。 pulls/<N>/comments は line comments（差分の行に紐づくレビューコメント）しか返さず、PR 本体に投稿された通常コメント（issue comment）は issues/<N>/comments からしか取得できない。

まず、列挙そのものはスクリプトで実行する。2 系統の --paginate 取得と bot の切り分けを決定論で行い、disposition の作業リストを出力する（refs #1827）。

npm run check:comment-disposition -- $ARGUMENTS

• 終了コード 0 = 人間由来のコメントなし（Step 2 は pass）、1 = 人間由来のコメントあり（出力された各件の disposition を確定するまで pass にしない）、2 = 使い方の誤りまたは gh の失敗
• exit 1 は「マージ禁止」ではなく「確認せよ」を意味する。disposition 済みかどうかをスクリプトは判定しない（判定できないため。理由は下記「なぜスクリプトは disposition の完了まで見ないか」）
• 人間 / bot の切り分けは GitHub API の user.type（Bot / User）で行い、bot 名の除外リストは持たない。ただし PAT で動く自動化は user.type: "User" を返すため、bot が人間として列挙されることがある。その場合は投稿者名で判断する
• スクリプトが gh の失敗などで exit 2 になった場合は、下記の生コマンドへフォールバックする

生コマンド（スクリプトが使えない場合、または本文全体を読みたい場合）:

gh api --paginate "repos/:owner/:repo/pulls/$ARGUMENTS/comments?per_page=100" \
  --jq '.[] | {id, in_reply_to_id, user: .user.login, path, line, commit: .commit_id, body}'