docs(ai-loop): #896 TASK-0896 plan 正式化（C-3 APPROVED・c3.json 同梱）

[s977043]

概要

TASK-0896（検証ロジック共通契約層化 — 定数/hash/snapshot 三つ組照合の重複解消）の plan 正式化 PR（1 PR 完結方式: plan 一式 + C-3 APPROVED c3.json 同梱）。

• Issue: refactor(ai-loop): 検証ロジックの共通契約層化 — 定数/hash/snapshot三つ組照合の重複解消（#873/#874 前の基盤整理） #896（P1 / EPIC [P0][EPIC] ai-loop vNext — ai-dev統合・C-3’・Merge-ready・Evolution Loopを一つの実行契約へ接続する #870 の [P0] PR作成後のCI・レビュー対応をMERGE_READY状態機械として実装する #873/[P1] ai-loop Run Evidence契約を統一し、Evolution LoopとPromotion Gateへ接続する #874 前基盤整理）
• Mode: high-risk（非 HO・振る舞い不変リファクタ・人間 C-3 必須）
• 実装順: [P0] PR作成後のCI・レビュー対応をMERGE_READY状態機械として実装する #873 と並行（C-3 確定・EPIC へ記録済み: https://github.com/s977043/PlanGate/issues/870#issuecomment-5042068517）

ゲート通過状況

ゲート	結果
B-1〜B-3	plan/todo/test-cases 生成（重複 5 点を行番号実測裏取り・Metrics 実数 9/見積 9 = 1.0）
C-1	PASS（WARN 1 = T-11 粒度・exec 時サブ分割）
C-2	2 レーン完了（Codex 設計妥当性 major 4 → 採用 3/不採用 1〔経路違い〕・コードベース整合 9/9 照合 OK）
確定反映	R-001/R-003〜R-010 を 1 回反映（f6bf1a9）+ 監査表 reflected_in 記入・簡易 C-1 PASS
C-3	APPROVED（Human・bin/plangate approve L1-L4 presence gate 通過・plan_hash 8cb2d72c 整合・validate 全 PASS）

設計の要点

• scripts/ai-loop/c3_contract.py 新設（中立配置）: 契約定数（REQUIRED_KEYS 系含む）+ I/O なし純関数（canonical_hash / check_snapshot_trio）+ I/O あり（sha256_of_file）の層分離
• 既存の検証強度非対称を保存: arbiter=余剰キー許容 / c3prime=strict（feat(TASK-0872): #872 PR-2 — c3-prime 受理器（非HO）+ HO patch 群（Human 適用） #889 R2 由来）を strict_keys 引数で挙動不変のまま共通化。reviewer 集合の非対称も同様に保存
• 理由文字列リスト契約（順序 = 検査順で固定 + 代表文言回帰テスト）
• 1 コミット 1 種類の 4 コミット（定数→hash→trio→sync）・各コミットで 4 系テスト green 維持
• exec は PLANGATE_HOOK_TASK=TASK-0896 セッションでメイン直実装（EH-1 正規経路）

マージ後

exec 開始（todo.md T-1〜T-17）。c3_contract 先行 merge 後に #873 が rebase する並行運用。

Refs: #896

🤖 Generated with Claude Code

[gemini-code-assist]

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[github-actions]

Check PR Issue Link: WARN: no closing keyword found (expected one of: closes #N / fixes #N / resolves #N)

• 推奨: PR 本文に closes #N / fixes #N / resolves #N を含めてください
• 対象外の場合: PR に chore / documentation ラベルを付けるか、PR 本文に <!-- skip-issue-link-check --> を含めてください
• 詳細: Issue #159