{{include:policies/evidence-based-judgment}}

# 契約置換ポリシー

既存契約の保持、現行利用側の移行、置換対象の旧契約を支える互換・移行を分離し、要求ソースが認めた範囲だけを実装する。

## 原則

| 原則 | 基準 |
|------|------|
| 対象外契約の保持 | 要求の変更対象外にある観測可能な既存契約は維持する |
| 利用側移行 | 置換対象の旧契約を使う現行利用側は新契約へ移行する |
| 旧経路削除 | 明示的に支援対象とされた経路を除き、置換対象の旧経路は削除する |
| 明示要求だけを採用する | 後方互換、legacy support、移行支援、並存は、要求ソースが明示した対象・範囲だけを許可する |
| 必要な方式だけを使う | 要求が方式を指定した場合はそれを守り、指定がなければ受入条件と実在する安全条件を満たす方式を選ぶ |
| 同一決定境界の衝突 | 明示変更と維持候補が同じ観測値・状態遷移・副作用を競合して決める場合、重なる状態では明示変更をそのまま適用する |
| 主操作の終端到達 | 主操作の入力・決定が生成、永続化、状態遷移を経て、後続の実行・表示・APIなどの終端 consumer へ届く経路を先に追跡する |

## 置換対象の旧形式

置換要求に旧形式の読込が明記されていない場合、旧形式の正規表現・変換分岐・fallback は削除対象とする。保存済みデータの存在、読込境界への隔離、低リスクという事情は、互換性を許可する根拠にならない。レビューでは旧形式の残存を問題として扱い、削除を修正案に含める。

旧形式との併存が明示されている場合は、(1) 新規書込が新形式だけを生成すること、(2) 新形式を読込・復元すること、(3) 要求された旧形式を読込・復元することを別々に確認する。旧形式の読込を許可したことから、書込、移行、backfill、別契約の互換性まで推論しない。

| 判定 | 基準 |
|------|------|
| REJECT | 旧形式を新形式へ置き換える要求で、旧形式の読込・変換・fallback・互換経路が明示されていないのに残す |
| REJECT | 保存済みデータの存在、読込境界への隔離、低リスクという理由だけで旧形式の支援を正当化する |
| OK | 要求が明示した範囲に限り、指定された旧形式の読込だけを新形式と併存させる |

## 判定基準

| 基準 | 判定 |
|------|------|
| 変更対象外にある観測可能な既存契約を維持する | OK |
| 置換対象の旧契約を使う現行利用側を新契約へ移行する | OK |
| 旧契約の生成・読込・alias・fallback・変換・upcaster・backfill・data migration・rebuildを、対象への明示要求なしに追加・維持する | REJECT |
| 明示された支援の対象・範囲を超える、または不要な方式を追加する | REJECT |
| API互換の要求をevent upcaster、data migration・backfill、Read Model rebuildなど別の支援対象へ広げる | REJECT |
| 要求ソースにない期限、廃止時期、終了条件、移行日程を要求または補完する | REJECT |

## 明示変更と維持契約の重なり

既定値、優先順位、選択結果、状態遷移、または副作用を要求ソースが明示的に変更した場合、同じ決定境界にある既存候補との重なりを解消する。変更対象外契約の保持は、明示変更と競合しない入力・状態・効果に限る。

| 基準 | 判定 |
|------|------|
| 明示変更の候補と維持候補が同時に成立し、同じ観測値・状態遷移・副作用を別々に決める | 明示変更を優先して適用し、維持候補は独立して残る振る舞いだけ保持する |
| 既存選択肢の可用性を維持することを、その選択肢の旧既定値・旧優先順位も維持することへ広げる | REJECT |
| 明示された既定値・優先順位を、現行実装や安全性の好みから `best effort`、任意、「可能なら」へ弱める | REJECT |
| 同じ位置、名前、または結果ラベルを持つ操作を、状態保持・再実行・副作用が異なるまま同一視する | REJECT |
| 同じ決定境界を共有しない契約まで組合せて網羅する | REJECT。契約外の組合せ軸を追加しない |
| 競合する候補を個別入力で検証し、両方が共存する入力で winner と操作効果を検証しない | REJECT |
| 選択値やカーソルが操作を指し、その操作効果が候補を区別する場合に、値の一致だけを検証して選択された操作の種類・効果を検証しない | REJECT |
| 同じ決定について候補が競合する最小の共存入力・状態で、選択値と要求に関係する状態遷移・副作用を直接検証する | OK |
| 現行実装・既存テスト・mock・fixture・完了報告が示す挙動を、明示変更と競合する入力・状態・副作用について既存契約として保持する | REJECT。明示変更を適用する |

## 主操作と終端 consumer

変更対象の主操作は、選択や生成だけで完了したとみなさず、下流の終端 consumer が実際に使う状態まで追跡する。復旧、互換、fallback などの secondary 経路は、主操作の経路を閉じた後に、主操作を置き換えない独立した契約として、要求された保持範囲だけを確認する。

| 基準 | 判定 |
|------|------|
| 主操作の producer、永続化または状態遷移、後続 consumer、terminal effect が同じ不変条件を共有する | 1つの経路として追跡し、各境界の観測可能な効果を直接検証する |
| 主操作の決定を保存した後、別の実行・処理がその保存値を読む | 保存値の生成から後続 consumer の実行結果までを先に確認する |
| secondary 操作が同じ選択画面や状態を共有する | 主操作の winner を置き換えず、secondary は要求された独立した効果だけ保持する |
| secondary の可用性・互換性を理由に、主操作の terminal consumer や状態遷移を評価対象から外す | REJECT |
| 主操作と secondary の組合せを、実在する決定境界・consumer が要求していない軸まで増やす | REJECT。主操作の最小 end-to-end 契約に限定する |

## 根拠の境界

現行コード、既存テスト・利用箇所、mock・fixture・test double、修正完了報告、保存済みデータ、公開・リリース状態、読込境界への配置・隔離は、影響経路と現行利用側を調べる証拠として扱う。それだけでは、置換対象の旧契約を維持する要件にならない。

保持すべき既存契約と判断する場合は、元要件・受入条件・公開仕様・実在する利用側の依存のいずれがその振る舞いを要求するかを特定する。特定できない挙動は、現在そう動いているという事実として扱う。

明示的な支援要求がある場合も、対象と範囲を記録し、その振る舞いを直接検証する。支援対象ごとに独立して判定し、1つの対象への要求を他へ広げない。

修正計画やレビューで示された方式は、そのまま元要求の必須条件にはならない。元要求が方式を指定していない場合は、採用済みの指摘の受入条件、実際の原因、既存契約と安全条件から必要性を確認する。指定された方式や必須の安全条件は、最小差分を理由に省略しない。

## contract-lifecycle 判定基準

### ライフサイクル網羅

| 基準 | 判定 |
|------|------|
| 変更したフィールドや振る舞いを生成元または型定義だけ更新している | REJECT |
| 検証、直列化、導出値、別入口、利用元が旧来の意味を残している | REJECT |
| 影響するすべてのライフサイクル境界が同じ必須の意味を保つ | OK |
| 契約を受け取れず導出もできない根拠を示して、影響しない境界を除外している | OK |

### 等価経路

| 基準 | 判定 |
|------|------|
| 一方の入口だけが制約を検証または保存し、等価な入口が迂回できる | REJECT |
| 再試行、再生、import、導出経路が仕様なしに契約の意味を変える | REJECT |
| 等価経路の意図的な違いを元要件または仕様が定めている | OK |

### 入口別経路と資源所有権

経路と終端の確認は、元要求、採用済みの指摘、または今回の変更が直接影響する契約に限る。今回の変更で生じた不具合や必須の安全条件は含め、無関係な資源の全終端へ広げない。

| 基準 | 判定 |
|------|------|
| CLI、API、pipeline、再実行などで producer、validator、consumer のいずれかが異なる | 別経路として扱う。1経路の充足だけでは他を証明しない |
| 到達不能または契約に非影響である根拠なく経路を除外する | REJECT |
| 所有者または所有権移譲が不明なまま、last consumer より前に資源を解放する | REJECT |
| 調査または再開に必要な永続 artifact を一時資源と同様に消去する | REJECT |
| 成功、失敗、中断、再試行で所有権と last consumer に沿った寿命契約を保つ | OK |

### 元契約に対する解消

| 基準 | 判定 |
|------|------|
| 局所修正だけで、等価なライフサイクル経路を確認せず解消扱いにする | REJECT |
| 元要件と矛盾する現行実装の振る舞いを、テストが固定しているだけ | REJECT |
| 元要件が影響するすべての経路で成り立つ証跡がある | OK |
