Summary

Issue #1476 は、deploy-pages.yml の deploy-main / deploy-pr 両ジョブが pnpm/action-setup に個別の version: 入力（10、11、11.1.2 等）を渡しており、実際にブートストラップされる pnpm のバージョンが workflow ファイルごと・ジョブごとにばらつく問題を解消するものです。今後は package.json の packageManager フィールド（pnpm@11.7.0）を唯一の正規値（single source of truth）とし、deploy-main と deploy-pr の両ジョブが常に同一バージョンの pnpm を決定論的にブートストラップするようにしました。

• package.json に packageManager: "pnpm@11.7.0" を追加し、pnpm バージョンの唯一の正規値とした。
• .github/workflows/deploy-pages.yml の deploy-main / deploy-pr 両ジョブから pnpm/action-setup の重複 version: 入力を撤去し、両ジョブに「実際に解決された pnpm --version が package.json#packageManager から実行時に導出した値と一致することを確認する」アサーションステップを追加した。バージョン不一致時は exit 1 で fail-closed とし、エラー抑制は行わない。アサーションの期待バージョンは node -e で package.json#packageManager から動的に導出しており、workflow 側にリテラルのバージョン文字列はハードコードしていない（ハードコードは契約テストにのみ存在）。
• .github/actions/setup-node-pnpm/action.yml、.github/workflows/agent-retro-index.yml、.github/workflows/session-manifest.yml の pnpm consumer 3 ファイルから、個別の version: 入力を撤去し、package.json#packageManager に一本化した。
• .github/**/*.yml 配下の全 pnpm/action-setup consumer を静的にスキャンし、未レビューの新規 consumer 追加を fail させる契約テストを追加した（レビュー済み consumer は deploy-pages.yml / session-manifest.yml / agent-retro-index.yml / setup-node-pnpm/action.yml の 4 ファイルにホワイトリスト化）。
• agent-retro-index.yml に read-only な bootstrap-smoke job を追加し、pull_request トリガーでこのファイル自身の pnpm bootstrap 経路を実際に CI で実行・検証できるようにした（既存の書き込み job である build-index / upsert-parent-comment は pull_request イベントを明示的に除外している）。
• scripts/ci/tests/test_deploy_pages_pnpm_setup.py に、baseline-red fixture（pytest collection error ではなく安定した failure key での exit 1 を検証）・repository 全体の pnpm consumer 契約・version-assertion スクリプトの behavioral（subprocess）検証・agent-retro-index.yml の bootstrap-smoke 契約を含む契約テストを追加した。

このプルリクエストのマージにより Issue #1476 は自動的にクローズされる。Closes #1476

Checks

• pnpm typecheck を実行し、型検査が通過することを確認した。
• pnpm lint を実行し、lint 違反がないことを確認した。
• pnpm test を実行し、既存テストが全て通過することを確認した（96 files / 1575 tests PASSED）。
• pnpm build を実行し、ビルドが成功することを確認した。
• uv run --locked pytest scripts/ci/tests/test_deploy_pages_pnpm_setup.py -v を実行し、契約テスト 26 件全てが green であることを確認した。
• uv run pytest .claude/skills/gemini-cli-headless-delegation/tests/test_model_routing.py を実行し、21 件全て PASSED であることを確認した。
• actionlint（v1.7.12、CI と同一バージョン）を全 workflow に対してローカル実行し、violation 0 件であることを確認した（前回の SC2016 false positive は shellcheck disable コメントで解消済み）。

受け入れ条件の達成状況

• AC1: package.json#packageManager は pnpm@11.7.0 を完全一致で定義しており、major range・latest・wildcard を含まない唯一の pnpm version source である。根拠: package.json diff（"packageManager": "pnpm@11.7.0" の追加）、test_deploy_jobs_require_package_manager_pinned_bootstrap PASSED。
• AC2: deploy-main / deploy-pr 両ジョブは upstream v6.0.8 の commit SHA 0e279bb959325dab635dd2c09392533439d90093 を維持し、version: input を重複指定していない。根拠: deploy-pages.yml diff、test_action_setup_sha_is_pinned_without_duplicate_version_input[deploy-main] / [deploy-pr] PASSED。
• AC3: 両ジョブは pnpm install --frozen-lockfile の前に pnpm --version を実行し、package.json#packageManager から実行時に導出した期待値と不一致なら exit 1 する set -euo pipefail ステップを持ち、bootstrap 手順は両ジョブで意味論的に同一、error suppression は存在しない（workflow 側にリテラル 11.7.0 はハードコードされていない）。根拠: deploy-pages.yml の「Assert resolved pnpm version matches packageManager」ステップ、test_pnpm_version_is_asserted_before_frozen_install_with_no_suppression[deploy-main] / [deploy-pr] PASSED（ハードコード不在の検査を含む）、test_deploy_main_and_deploy_pr_bootstrap_steps_are_semantically_identical PASSED、test_no_error_suppression_anywhere_in_bootstrap_or_install_steps PASSED、test_version_assertion_script_exits_zero_on_exact_match / exits_nonzero_on_patch_mismatch / exits_nonzero_on_missing_package_manager / exits_nonzero_on_range_package_manager（各 [deploy-main] / [deploy-pr]）による subprocess behavioral 検証 PASSED。実行時証跡は本セクション下部の Runtime Verification Evidence を参照。
• AC4: scripts/ci/tests/test_deploy_pages_pnpm_setup.py は packageManager 値・action SHA・version: input 不在・両ジョブの bootstrap 同値性・assertion と install の順序・error suppression 不在に加え、.github/**/*.yml 全体の pnpm consumer whitelist・agent-retro-index.yml の bootstrap-smoke 契約を検査する。修正前 fixture（test_pre_fix_fixture_reports_non_exact_pnpm_version_as_assertion_failure）は、独立した CLI エントリポイント経由で安定した failure key non_exact_pnpm_version（および duplicate_version_input:deploy-main / missing_version_assertion:deploy-main）を伴う exit code 1 を返すことを確認しており、pytest collection error（exit code 4 / 0 collected items）ではないことを明示的に検証している。根拠: scripts/ci/tests/test_deploy_pages_pnpm_setup.py 本体、Issue 実装: deploy-pr の pnpm self-installer failure を決定論的に解消する #1476 Verification Commands の # baseline-expect: fail 指定に対応。
• AC5: scripts/ci/tests/test_deploy_pages_pnpm_setup.py は現行 HEAD で 26 件全て PASS する。根拠: 下記「検証コマンド結果」参照（uv run --locked pytest scripts/ci/tests/test_deploy_pages_pnpm_setup.py -v 実行結果）。
• AC6: current-head（e268771927206f4307ee40867a2997cfbfe64e8c）の deploy-pr は成功しており、PR number・40 桁 head SHA・workflow run ID・run attempt・job URL・expected/actual pnpm version・pnpm install --frozen-lockfile 成功を含む evidence を「Runtime Verification Evidence」セクションに記載した。agent-retro-index.yml の新規 bootstrap-smoke job も同一 head で pull_request イベントにより実際に実行され成功しており、この workflow の pnpm bootstrap 経路が初めて PR-scoped CI で検証された（P1-3 対応）。deploy-main は publish を伴わず静的整合のみ確認対象（本 Issue のスコープ通り）。根拠: 下記「Runtime Verification Evidence」参照。
• AC7: pnpm typecheck が PASS する。根拠: CI check typecheck = SUCCESS（head e268771927206f4307ee40867a2997cfbfe64e8c）。
• AC8: pnpm lint が PASS する。根拠: CI check lint = SUCCESS（head e268771927206f4307ee40867a2997cfbfe64e8c）。
• AC9: pnpm test が PASS する。根拠: CI check test = SUCCESS（head e268771927206f4307ee40867a2997cfbfe64e8c）。
• AC10: pnpm build が PASS する。根拠: CI check build = SUCCESS（head e268771927206f4307ee40867a2997cfbfe64e8c）。
• AC11: .claude/skills/pr-review-judge/scripts/ci_verdict_summary.py の HEAD_SHA_NULL_SKIPPED_EXCLUDE_RULES に agent-retro-index の build-index / upsert-parent-comment（conclusion: skipped, head_sha: null）を含む非対応写像パターンを追加し、uv run --locked pytest .claude/skills/pr-review-judge/scripts/tests/test_ci_verdict_summary.py -v が PASS する。根拠: commit e268771927206f4307ee40867a2997cfbfe64e8c、CI check ci-verdict-summary（head e268771927206f4307ee40867a2997cfbfe64e8c）= SUCCESS（run 29181253101 / job 86619439166）。これは直前の pr-reviewer REQUEST_CHANGES（reviewed_head_sha 539cf01a96804520b146148ea8a98a28f6b412a3）の blocker 1 を解消する。

検証コマンド結果

• 契約テスト全件（uv run --locked pytest scripts/ci/tests/test_deploy_pages_pnpm_setup.py -v）を worktree 内（head e268771927206f4307ee40867a2997cfbfe64e8c）で実行し、以下の結果を得た。

collected 26 items

test_pre_fix_fixture_reports_non_exact_pnpm_version_as_assertion_failure PASSED
test_post_fix_current_repo_has_no_violations PASSED
test_deploy_jobs_require_package_manager_pinned_bootstrap PASSED
test_action_setup_sha_is_pinned_without_duplicate_version_input[deploy-main] PASSED
test_action_setup_sha_is_pinned_without_duplicate_version_input[deploy-pr] PASSED
test_pnpm_version_is_asserted_before_frozen_install_with_no_suppression[deploy-main] PASSED
test_pnpm_version_is_asserted_before_frozen_install_with_no_suppression[deploy-pr] PASSED
test_deploy_main_and_deploy_pr_bootstrap_steps_are_semantically_identical PASSED
test_no_error_suppression_anywhere_in_bootstrap_or_install_steps PASSED
test_all_pnpm_action_setup_consumers_are_whitelisted PASSED
test_no_pnpm_action_setup_consumer_declares_version_input PASSED
test_composite_action_does_not_reintroduce_pnpm_version_input PASSED
test_pnpm_setup_precedes_pnpm_commands_in_every_whitelisted_job PASSED
test_version_assertion_script_exits_zero_on_exact_match[deploy-main] PASSED
test_version_assertion_script_exits_zero_on_exact_match[deploy-pr] PASSED
test_version_assertion_script_exits_nonzero_on_patch_mismatch[deploy-main] PASSED
test_version_assertion_script_exits_nonzero_on_patch_mismatch[deploy-pr] PASSED
test_version_assertion_script_exits_nonzero_on_missing_package_manager[deploy-main] PASSED
test_version_assertion_script_exits_nonzero_on_missing_package_manager[deploy-pr] PASSED
test_version_assertion_script_exits_nonzero_on_range_package_manager[deploy-main] PASSED
test_version_assertion_script_exits_nonzero_on_range_package_manager[deploy-pr] PASSED
test_agent_retro_index_has_pull_request_trigger PASSED
test_agent_retro_index_write_jobs_are_excluded_from_pull_request[build-index] PASSED
test_agent_retro_index_write_jobs_are_excluded_from_pull_request[upsert-parent-comment] PASSED
test_agent_retro_index_has_read_only_bootstrap_smoke_job PASSED
test_agent_retro_index_smoke_job_version_assertion_is_bootstrap_equivalent PASSED

26 passed in 0.88s

• AC6（gh pr view 1480 --repo squne121/loop-protocol --json statusCheckRollup）: deploy-pr = SUCCESS（run ID 29180309038、job ID 86616731894、head SHA e268771927206f4307ee40867a2997cfbfe64e8c）。bootstrap-smoke（agent-retro-index.yml）= SUCCESS（run ID 29180309083、job ID 86616584817、同一 head）。詳細は「Runtime Verification Evidence」参照。
• AC7〜AC10: CI 上の typecheck / lint / test / build check（head e268771927206f4307ee40867a2997cfbfe64e8c）が全て SUCCESS であることを gh pr view 1480 --json statusCheckRollup で確認した（ローカル pnpm 未導入のためローカル代替 PASS は行わず、CI check 結果を正本として扱う）。

Allowed Paths 遵守

Issue #1476 が定義する Allowed Paths（許可済み変更対象パス）は、当初 6 ファイルであったが、AC11（ci_verdict_summary.py の agent-retro-index allowlist 修正）に対応するため、人間承認済みの第 2 回 Scope Delta で .claude/skills/pr-review-judge/scripts/ci_verdict_summary.py と .claude/skills/pr-review-judge/scripts/tests/test_ci_verdict_summary.py の 2 ファイルが追加され、以下の合計 8 ファイルとなっている。

• .github/workflows/deploy-pages.yml（対象ファイル）
• scripts/ci/tests/test_deploy_pages_pnpm_setup.py（対象ファイル）
• package.json（対象ファイル）
• .github/actions/setup-node-pnpm/action.yml（対象ファイル）
• .github/workflows/session-manifest.yml（対象ファイル）
• .github/workflows/agent-retro-index.yml（対象ファイル）
• .claude/skills/pr-review-judge/scripts/ci_verdict_summary.py（対象ファイル、第 2 回 Scope Delta で追加・AC11）
• .claude/skills/pr-review-judge/scripts/tests/test_ci_verdict_summary.py（対象ファイル、第 2 回 Scope Delta で追加・AC11）

実際の変更ファイル一覧（gh pr view 1480 --repo squne121/loop-protocol --json files、head e268771927206f4307ee40867a2997cfbfe64e8c）:

.claude/skills/pr-review-judge/scripts/ci_verdict_summary.py
.claude/skills/pr-review-judge/scripts/tests/test_ci_verdict_summary.py
.github/actions/setup-node-pnpm/action.yml
.github/workflows/agent-retro-index.yml
.github/workflows/deploy-pages.yml
.github/workflows/session-manifest.yml
package.json
scripts/ci/tests/test_deploy_pages_pnpm_setup.py

両者（Allowed Paths 8 ファイルと実際の変更ファイル一覧 8 ファイル）は完全に一致しており、Allowed Paths からの逸脱はない。agent-retro-index.yml への bootstrap-smoke job 追加（P1-3 対応）も、Allowed Paths に元々含まれる同一ファイル内の変更であり、スコープ外の逸脱ではない。

Runtime Verification Evidence（実行時検証証跡）

Issue #1476 の AC3 / AC6（<!-- runtime-verification: true -->）に対応する current-head（e268771927206f4307ee40867a2997cfbfe64e8c）実行時証跡。

deploy-pages / deploy-pr（本体ジョブの証跡）

• PR number: 1480
• head SHA（40 桁）: e268771927206f4307ee40867a2997cfbfe64e8c
• workflow: deploy-pages
• job: deploy-pr
• workflow run ID: 29180309038
• run attempt: 1
• job ID: 86616731894
• job URL: https://github.com/squne121/loop-protocol/actions/runs/29180309038/job/86616731894
• expected pnpm version（package.json#packageManager から実行時導出）: 11.7.0
• actual pnpm version（ジョブログより）: 11.7.0（Successfully updated pnpm to v11.7.0 の後、「Assert resolved pnpm version matches packageManager」ステップが OK: resolved pnpm version matches expected 11.7.0 を出力）
• pnpm install --frozen-lockfile 実行結果: 成功（Lockfile is up to date, resolution step is skipped / Packages: +576 / ✓ Lockfile passes supply-chain policies (608 entries in 3s)）
• 結論: current-head の deploy-pr は成功しており、AC3 のバージョン一致アサーションと AC6 の runtime evidence 要件を満たす。deploy-main は publish を伴わないため本 Issue のスコープ通り静的整合のみを検証対象とした。

agent-retro-index / bootstrap-smoke（P1-3 対応の新規証跡）

• workflow: agent-retro-index
• job: bootstrap-smoke
• workflow run ID: 29180309083
• run attempt: 1
• job ID: 86616584817
• job URL: https://github.com/squne121/loop-protocol/actions/runs/29180309083/job/86616584817
• trigger: pull_request（PR fix: deploy-pr の pnpm self-installer failure を決定論的に解消する #1480 head e268771927206f4307ee40867a2997cfbfe64e8c）
• actual pnpm version（ジョブログより）: OK: resolved pnpm version matches expected 11.7.0
• 同一 run 内の書き込み job（build-index / upsert-parent-comment）は if: github.event_name != 'pull_request' によりいずれも SKIPPED（意図通り。write side effect なしで bootstrap のみ検証）。
• 結論: agent-retro-index.yml の pnpm bootstrap 経路が、本 PR 自身の CI 上で実際に（静的テストのみでなく）実行・検証された。

Schema Change Applicability

• decision: not_schema_change
• reason: package.json と GitHub Actions workflow YAML の変更であり、アプリケーションが公開する API/データスキーマの変更は含まない。

Schema Consumer Inventory

N/A
reason: スキーマ変更に該当しないため consumer inventory の記載は不要。

Safety Claim Matrix

このPRは .github/workflows/ 配下を変更するため safety-sensitive として扱う。

Notes

• 関連 Issue: 実装: deploy-pr の pnpm self-installer failure を決定論的に解消する #1476
• pnpm/action-setup の SHA ピン留めについて: deploy-pages.yml / session-manifest.yml は既に commit SHA 完全一致でピン留め済みだが、setup-node-pnpm/action.yml（pnpm/action-setup@v6）と agent-retro-index.yml（pnpm/action-setup@v4）は mutable なバージョンタグのままである（Safety Claim Matrix 参照）。本 PR は pnpm version の single-source-of-truth 化（package.json#packageManager）が Issue 実装: deploy-pr の pnpm self-installer failure を決定論的に解消する #1476 のスコープであり、Action 実装自体の SHA pin 統一は Issue 実装: pnpm/action-setup の mutable tag を commit SHA pin に固定する（#1476 follow-up） #1484 として起票済みの follow-up で対応する。
• adversarial review（https://github.com/squne121/loop-protocol/pull/1480#issuecomment-4949640926）で指摘された P0/P1/P2 の対応状況:
  • P0-1（baseline-red fixture が pytest collection error でなく安定した failure key を伴う exit 1 を返すことの検証）: 対応済み。
  • P0-2（current-head evidence の陳腐化）: 本更新で解消（head e268771927206f4307ee40867a2997cfbfe64e8c に更新）。
  • P1-1（version assertion のハードコード撤去、package.json#packageManager からの実行時導出への変更）: 対応済み。
  • P1-2（.github/**/*.yml 全体の pnpm consumer 契約テスト）: 対応済み。
  • P1-3（agent-retro-index.yml の pnpm bootstrap 経路を実際に CI で検証する read-only smoke job の追加）: 対応済み。
  • P1-4（version-assertion スクリプトの behavioral / subprocess 検証）: 対応済み。
  • P2（Safety Claim Matrix の Not controlled 過大表現の是正）: 本更新で解消（上表参照）。
• 直近の pr-reviewer レビュー（commit 539cf01a96804520b146148ea8a98a28f6b412a3 時点、REQUEST_CHANGES）で指摘された 2 件の blocker の対応状況:
  • blocker 1（ci_verdict_summary.py の HEAD_SHA_NULL_SKIPPED_EXCLUDE_RULES に agent-retro-index の build-index / upsert-parent-comment skipped job の非対応写像パターンが欠落し、ci-verdict-summary job が false failed_checks を報告していた問題）: commit e268771927206f4307ee40867a2997cfbfe64e8c（AC11）で解消済み。current head での ci-verdict-summary CI check = SUCCESS（run 29181253101 / job 86619439166）で確認済み。
  • blocker 2（Safety Claim Matrix の Follow-up 列に、pnpm/action-setup mutable tag pin 化の追跡先 Issue リンクが欠落していた問題）: Issue 実装: pnpm/action-setup の mutable tag を commit SHA pin に固定する（#1476 follow-up） #1484 を起票し、Safety Claim Matrix の Follow-up 列に反映して解消済み（上記 Safety Claim Matrix 参照）。