# Phase 284 P1（code）: Return as ExitKind SSOT（実装）

目的: `return` を pattern 固有の特例にせず、`ExitKind::Return` と `compose::*` / `emit_frag()` へ収束させる。

前提SSOT（P0）:
- `docs/development/current/main/phases/phase-284/README.md`
- Phase 282 の境界ルール（SSOT=extract / close-but-unsupported=Err）: `docs/development/current/main/phases/phase-282/README.md`

## 実装方針（最小）

### 1) 返り値の運搬（ExitKind::Return + args）

- `return <expr>` は **`ExitKind::Return` の edge**として表現する。
- Return edge が持つ値は `EdgeArgs` で運ぶ（Return terminator の operand）。
- terminator は `emit_frag()` が生成する（pattern/box が直に Return 命令を生やさない）。

### 2) 「移行期間の穴」を消す

現状は Pattern4/5 などが `return` を `Err(close-but-unsupported)` にしている。
P1 のゴールは:
- `return` を含む loop-body が “別パターンへ静かに流れる” 状態をなくす
- SSOT 経路で `ExitKind::Return` に落ちるようにする

## 実装タスク（推奨順）

### Step 1: 現状の `return` ハンドリングを棚卸し（read-only）

- joinir patterns extractors:
  - `src/mir/builder/control_flow/joinir/patterns/extractors/pattern4.rs`
  - `src/mir/builder/control_flow/joinir/patterns/extractors/pattern5.rs`
  - `return` を Err にしている箇所（close-but-unsupported の根拠）を列挙する

- control-flow lowering:
  - `emit_frag()` が Return edge をどう生成しているか確認する（target=None の Return wire/exit）
  - `compose::cleanup()` の Return wiring が想定どおりか確認する

成果物: `docs/development/current/main/phases/phase-284/P1-NOTES.md`（短い箇条書きでOK）

### Step 2: `return` を ExitKind に落とす “単一入口” を作る（root fix）

狙い:
- loop body のどの位置でも `return` が現れたら `ExitKind::Return` で外へ出せること
- これを **1 箇所**に寄せる（pattern 側に増やさない）

実装候補（どれか 1 つに決める）:
- A) loop lowering（Frag 構築）段で Return edge を first-class で追加
- B) JoinIR conversion の merge 段で Return を ExitKind に正規化

要件:
- Fail-Fast: “表現できない return” は Err（silent fallback 禁止）
- 既定挙動は変えない（return を含む既存 fixture があれば、その期待値は明示して更新）

### Step 3: extractor の `return` ポリシーを更新（穴を埋める）

P1 で Return SSOT が通るようになったら、以下を更新する:
- Pattern4/5 の extractor で `return` を **Err にしない**（close-but-unsupported ではなくなるため）
- ただし “return があるせいでパターン形状が曖昧になる” 場合は Err を維持（Fail-Fast）

### Step 4: fixture + smoke（VM/LLVM）で SSOT を固定

最小 fixture の要件:
- `return` が loop の then/else どちらかに現れる
- exit code が安定（stdout 抑制の LLVM でも確認できる）

例（案）:
- `apps/tests/phase284_p1_return_in_loop_min.hako`
  - loop 内で条件により `return 7` / `continue` 等
  - 最終 exit code を 7 に固定

smoke:
- VM: stdout/exit code を検証
- LLVM: exit code + harness の `Result: <code>` を検証（stdout が出ない想定）

## 受け入れ基準

- `return` を含む loop fixture が VM/LLVM で同一動作
- pattern 側に “return の特例 if” が増えていない（root fix のみ）
- `Ok(None)` / `Err` の境界が崩れていない（silent fallback なし）