[P1][Supply Chain] codex-action例を監査済みcommit SHAへpinする

[ootakazuhiko]

背景

固定コミット 664720b0c08e431b1ec9dd7c705c22e2824d4595 のCodex review workflow例が第三者actionをmutableなmajor tagで参照しています。

根拠

• examples/workflows/codex-pr-review-comment.yml:36-42: openai/codex-action@v1
• GitHub Actions secure use:
  • https://docs.github.com/en/actions/reference/security/secure-use
• Action metadata/versioning:
  • https://docs.github.com/en/actions/reference/workflows-and-actions/metadata-syntax

影響

• tag移動により同一commitの教材でも実行codeが変わり、再現性とsupply-chain監査性が失われます。
• privileged workflowで未監査のupstream変更を実行する可能性があります。

対応範囲

• examples/workflows/codex-pr-review-comment.yml
• example READMEまたは更新方針

受け入れ条件

• actionを監査済みfull-length commit SHAへpinする。
• human-readable version commentを併記する。
• pin更新手順、upstream tag/SHA確認、review/CIを説明する。
• 既存read-only permissionとlabel gateを維持する。

検証方法

• pin SHAがupstreamの期待release commitであること。
• workflowをtest PRで実行し、expected permissionsのみで動作すること。
• active workflow/sampleにmutableな当該tagが残っていないこと。

対象外

• Codex Action採否の再設計
• 全repositoryの一括pin更新

重複確認

2026-07-19時点のopen #235、closed #212/#244、recent PR #209/#245を確認しました。book-formatter pinとは別actionであり、同一のopen Issueはありません。

[ootakazuhiko]

実行計画

前提の#246がCompleted、PR #250 merged、review unresolved 0、PR/main checks・Pages・公開HTTP成功、Open PR 0であることを確認しました。同一repository内を直列で、Issue #248だけを次の単位で処理します。

1. openai/codex-actionの公式upstream tagをAPIで監査し、annotated tagをcommitまでdereferenceする。2026-07-19時点でmutable v1とhuman-readable v1.11はいずれもcommit 52fe01ec70a42f454c9d2ebd47598f9fd6893d56を指すことを確認済み。
2. action.yml、配布物、依存lockfile、upstream CI/CHANGELOG、commit履歴を確認し、当該SHAを監査済み候補として確定する。検証結果に問題があればpin更新を中断する。
3. Issue対象のexample workflowと対応するChapter 13の掲載例を、full-length commit SHA + human-readable # v1.11へ統一する。既存のread-only permissions、label gate、sandbox/read-only contractは維持する。
4. pin更新手順（upstream tag/SHA確認、差分/依存監査、test PR、review/CI、更新記録）をexample READMEまたは対象節に追記する。
5. mutableなopenai/codex-action@v1がactive workflow/sampleに残っていないことを決定的に検査する契約checkerとnegative self-testを、既存QA規約に沿って最小追加する。
6. Node 24でローカルQA、actionlint、YAML parse、audit、Jekyll build、diff checkを実行し、独立security reviewでactionable finding 0にする。
7. 1 Issue = 1 PRで提出し、review本文・inline・suggestion・threadを全件処理する。unresolved 0、CI green後にmergeし、main checks、Pages、公開HTTP/markerを確認する。

実repository settings、Codex Actionの採否、他repositoryのpinは変更しません。test PRでの実action実行は、secret/tokenを安全に供給できる既存契約がない場合は実施せず、upstream CI・静的契約・本repository CIを代替証跡として制約を明記します。

[ootakazuhiko]

upstream監査結果と実装判断

openai/codex-actionを公式repository上で監査しました。

採用するpin

• action commit: 52fe01ec70a42f454c9d2ebd47598f9fd6893d56
• human-readable tag: v1.11
• v1 annotated tag object b11346a...とv1.11 annotated tag object 7c168a...はいずれも上記commitを指す。
• tag自体はunsigned、target commitはGitHub APIでverified: true / valid。
• upstream CI run 28712691847はsuccess。
• target checkoutでpnpm install --frozen-lockfile、test 16/16、typecheck/check、build、dist再生成差分0を確認。

条件付き採用とする理由

full SHA pinだけではactionが実行時に導入するCodex CLIが浮動するため、教材では以下も固定・維持します。

• codex-version: 0.144.6（2026-07-19時点のstable exact version。CLIとresponses proxyの両packageで同版を確認）
• read-only用途はlegacy sandboxではなくpermission-profile: ":read-only"（CLI 0.138.0以降）
• safety-strategy: drop-sudo
• action jobはcontents: readのみ、checkoutはpersist-credentials: false
• 既存label gateとwrite権限を別jobへ分離する契約を維持

残存upstream risk

• targetのpnpm auditは10件（high 3 / moderate 5 / low 2）。主にproduction treeのundici、dev treeのesbuild。通常経路での到達可能性は未確定。
• GitHub Security Advisoryの公開は確認されなかった。
• target時点の既知open issue fix(nav): align prev/next titles; remove empty navigation.yml #99/Docs: 公開Pagesのリンク/画像/ナビ検証レポート #103/Docs: 公開Pagesのリンク/画像/ナビ検証レポート #105/#108により、self-hosted ARC、unprivileged-user、同一job複数回実行は本教材例の対象外とする。
• v1.11 tag時点のCHANGELOG/Release証跡は弱いが、後続mainでCHANGELOG追記済み。教材はtagではなくverified commitへpinする。

既存のmutable @v1も同じtarget commitを指しているため、今回の変更は既存riskを増やさず、実行codeとCLI版を固定して再現性を改善します。上記条件と残存riskを本文・更新手順に明記し、実装を進めます。

[ootakazuhiko]

完了証跡

• PR: ci: Codex Actionを監査済みSHAへ固定する #251
• squash merge: 56f54b261deec01776bb76877835f5f88a887c25
• 採用pin: openai/codex-action@52fe01ec70a42f454c9d2ebd47598f9fd6893d56 # v1.11、Codex CLI 0.144.6
• upstream監査: v1 / v1.11 annotated tagをtarget commitまでdereference。target commitはGitHub verified/valid、upstream CI 28712691847 success、target checkout test 16/16・check/typecheck・build・dist差分0
• upstream残存risk: pnpm audit 10件（high 3 / moderate 5 / low 2）。公開Security Advisoryなし、通常実行経路の到達可能性は未評価。GitHub-hosted単発/read-onlyへ限定し、self-hosted/ARC、unprivileged-user、同一job複数実行を対象外とした
• 独立security review: 初回2件（shell expression境界、audit/advisory表現）を修正後、actionable 0
• PR review completeness: 10 reviews / 12 inline comments / 6 threads / unresolved 0 / mismatch 0。Codex P2 3件、Copilot 3件を修正・返信・resolveし、最終Codex reviewはe78e0bcでmajor issueなし
• PR checks: Book QA 29687849643、Docs Forbidden 29687849638 success
• main checks: Book QA 29687973771、Docs Forbidden 29687973778 success
• Pages: 29687973367 success
• 公開確認: topと/chapters/chapter13/がHTTP 200。action SHA、Codex 0.144.6、fetch-depth、公開Security Advisoryの限定表現を確認
• repository-wide checker: .github/workflows、examples、src、docsのYAML/Markdownで全Codex Action refを監査済みSHAと照合。mutable/別SHA/引用符付きrefのnegative self-testをBook QAへ配線
• test PRでの実action実行は、安全に利用できる既存OPENAI_API_KEY・課金契約がないため未実施。upstream CI、upstream checkout検証、local/PR/main QAで代替した。