feat(joinir): Phase 245C - Function parameter capture + test fix

Extend CapturedEnv to include function parameters used in loop conditions, enabling ExprLowerer to resolve variables like `s` in `loop(p < s.length())`. Phase 245C changes: - function_scope_capture.rs: Add collect_names_in_loop_parts() helper - function_scope_capture.rs: Extend analyze_captured_vars_v2() with param capture logic - function_scope_capture.rs: Add 4 new comprehensive tests Test fix: - expr_lowerer/ast_support.rs: Accept all MethodCall nodes for syntax support (validation happens during lowering in MethodCallLowerer) Problem solved: "Variable not found: s" errors in loop conditions Test results: 924/924 PASS (+13 from baseline 911) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-11 13:13:08 +09:00
parent 00ecddbbc9
commit d4597dacfa
40 changed files with 2386 additions and 1046 deletions
--- a/docs/development/current/main/phase245-jsonparser-parse-number-joinir-integration.md
+++ b/docs/development/current/main/phase245-jsonparser-parse-number-joinir-integration.md
@ -0,0 +1,90 @@
+Status: Active → Close-out  
+Scope: JsonParser `_parse_number` のループを Pattern2（break 付き）で JoinIR 経路に載せるための設計決定メモ。
+
+# Phase 245-EX: JsonParser `_parse_number` の JoinIR 統合（1 本目）
+
+## 1. 目的 / スコープ
+- 目的: `_parse_number` のループを、既存の Pattern2 + ExprLowerer/ConditionEnv/CarrierUpdateEmitter で JoinIR 経路に載せる。
+- スコープ: このフェーズでは `_parse_number` のみ。`_atoi` / `_atof_loop` / `_parse_array` など他ループは後続フェーズ。
+- 明示: **扱うのは `p` の header / break / 更新のみ。`num_str` には手を出さない**（文字列連結キャリアは Phase 245B 以降で検討）。
+
+## 2. 現状の挙動と既存フェーズの整理
+- ループ概要（tools/hako_shared/json_parser.hako より）:
+  - ループ変数: `p`（文字走査位置）
+  - ヘッダ条件: `p < s.length()`
+  - body 計算: `ch = s[p]`; `digit_pos = digits.indexOf(ch)`
+  - break 条件: `digit_pos < 0`（非 digit で脱出）
+  - 更新: `p = p + 1`; 数値文字列の累積（`num_str = num_str + ch` 相当）あり
+- 参考フェーズ:
+  - ループ全体の設計/在庫: `phase181-jsonparser-loop-roadmap.md`, `phase174-jsonparser-loop-inventory-2.md`
+  - digit_pos / ConditionEnv 系: `phase200-A/B/C`, `phase224-digitpos-condition-normalizer.md`, `phase224-digitpos-promoter-design.md`
+  - ExprLowerer/ScopeManager: `phase230-expr-lowerer-design.md`, `phase236-exprlowerer-integration.md`, `phase237-exprlowerer-condition-catalog.md`, `phase238-exprlowerer-scope-boundaries.md`
+- 既にカバーされている要素:
+  - header 条件 `p < len` は ExprLowerer/ConditionEnv で扱える想定（Phase 230/236 系）
+  - break 条件 `digit_pos < 0` は digitpos 正規化経路で扱う前提（Phase 224 系）
+  - キャリア更新 `p = p + 1` は Pattern2/CarrierUpdateEmitter で許容
+- まだ本番経路に載っていない部分:
+  - 数値文字列の累積（`num_str`）の扱いを今回どうするか（キャリアに入れるか、今回は p 更新のみに絞るか）を決める必要あり。
+
+## 3. ターゲット JoinIR パターン / 箱構成
+- パターン: **Pattern2 (Break)** を基本とし、必要なら LoopBodyLocal 昇格（P5 相当の body-local 扱い）を併用。
+- ループ変数・キャリア・body-local・captured の対応表:
+  - loop var: `p`
+  - carriers: `p` は必須。`num_str` は今回の Phase では **任意**（下記の許可範囲で決める）。
+  - condition inputs: `p`, `s.length()`, `digit_pos`
+  - break 条件: `digit_pos < 0`
+  - body-local/captured: `s`, `digits` は captured 扱いで読み取りのみ。
+- 経由させる箱:
+  - ConditionEnv + ExprLowerer（header 条件 / break 条件）
+  - MethodCallLowerer（`digits.indexOf(ch)`）
+  - CarrierUpdateEmitter（`p = p + 1`、必要なら `num_str` 更新）
+
+## 4. 条件式・更新式パターンの許可範囲
+- ヘッダ条件: `p < s.length()` は ExprLowerer/ConditionEnv の既存カバー範囲で扱う（YES 前提）。
+- break 条件: `digit_pos < 0` を digitpos 正規化経路（Phase 224 系）に乗せる。Compare/Jump で Pattern2 に合流すること。
+- 更新式:
+  - 必須: `p = p + 1` を CarrierUpdateEmitter で扱う。
+  - 任意: `num_str = num_str + ch`  
+    - もし ExprLowerer/CarrierUpdate が文字列連結キャリアを安全に扱えるなら、キャリアとして含める。  
+    - 難しければ本フェーズは `p` の更新と break 条件の JoinIR 化に限定し、`num_str` は後続フェーズで扱うと明示。
+- 線引き:
+  - **今回扱う**: header 条件、break 条件、`p` 更新。`num_str` 更新は「可能なら扱う、無理なら後続」と書き分ける。原則として **Phase 245-EX では `num_str` をキャリアに載せない**。
+  - **後続に回す**: `_parse_array` / `_parse_object` / `_unescape_string` / if-sum/continue を含む Pattern3/4 の適用。
+
+## 5. 期待する検証方法（テスト観点）
+- 既存テストで固定したいもの:
+  - JsonParser の数値解析系スモーク（ファイル名/ケース名があれば列挙）。  
+  - 例: `"123"` → 数値として成功 / `"123a"` → 非 digit で break して期待どおりのパース失敗/戻り値になること。
+- 必要なら追加する最小ケース（例）:
+  - 入力: `"42"` → 正常に数値化（num_str が "42"）し、p が len に一致。
+  - 入力: `"7z"` → `z` で break、num_str が "7" で止まり、エラー/戻り値が従来と一致。
+- JoinIR レベル確認ポイント:
+  - header 条件が Compare + Jump で Pattern2 のヘッダに乗っていること。
+  - break 条件 `digit_pos < 0` が ConditionEnv/ExprLowerer 経由で JoinIR の break ブロックに接続していること。
+  - `p` の更新が CarrierUpdateEmitter で扱われ、LoopHeader PHI / ExitLine と矛盾しないこと。
+
+## 6. 非目標 / 今回はやらないこと
+- `_parse_array` / `_parse_object` / `_unescape_string` など他ループへの展開は本フェーズ外。
+- continue/if-sum を含む Pattern3/4 への適用は別フェーズ。
+- JsonParser 全体の設計変更や API 変更は行わない。ループ部分の JoinIR 経路追加/切り替えに限定。
+
+## 7. コード側 Phase 245-EX への引き継ぎメモ
+- 対象ループ: `_parse_number`
+- パターン: Pattern2 (Break) + 必要に応じて body-local 昇格（P5 相当）
+- 変数の役割:
+  - loop var: `p`
+  - carriers: `p`（必須）、`num_str`（可能なら含める/後続に回すかをここで決める）
+  - condition inputs: `p`, `s.length()`, `digit_pos`
+  - break 条件: `digit_pos < 0`
+  - captured: `s`, `digits`
+- 許可された式:
+  - header: `p < s.length()`
+  - break: `digit_pos < 0`
+  - 更新: `p = p + 1`（必須）、`num_str = num_str + ch`（扱うかどうかを本メモで明記）
+- 検証:
+  - 使うテストケース（既存/追加）と期待する挙動（RC/ログ）を本メモに列挙しておく。
+
+## 8. 完了メモ（Phase 245-EX 締め）
+- `_parse_number` の p ヘッダ条件（`p < s.length()`）・break 条件（`digit_pos < 0`）・更新（`p = p + 1`）を Pattern2 + ExprLowerer/CarrierUpdateEmitter 経路に載せた。
+- 既存の挙動確認: `cargo test --release phase245_json_parse_number -- --nocapture` を実行し、RC/ログともに従来からの差分なし（num_str 未導入のため外部挙動不変）。
+- 次フェーズ（245B）で扱うもの: `num_str` をキャリアに載せるかどうか、更新式の許容範囲、固定すべきテストを設計する。
--- a/docs/development/current/main/phase245b-jsonparser-num-str-carrier-design.md
+++ b/docs/development/current/main/phase245b-jsonparser-num-str-carrier-design.md
@ -0,0 +1,34 @@
+Status: Draft  
+Scope: `_parse_number` で `num_str` を Pattern2/P5 のキャリアとして扱うかどうかを決める設計フェーズ（コード変更なし）。
+
+# Phase 245B: JsonParser `_parse_number` の `num_str` キャリア設計
+
+## 1. 目的
+- `_parse_number` で数値文字列を蓄積する `num_str` を、JoinIR Pattern2/P5 のキャリアとして扱うかを決める。
+- UpdateExpr の許容範囲（例: `num_str = num_str + ch`）と、どのテストで意味論を固定するかを先に書き下す。
+
+## 2. 論点
+- キャリア化するか:
+  - Option A: `num_str` をキャリアとして Pattern2 に含める（LoopHeader PHI/ExitLine まで通す）。
+  - Option B: 今フェーズは `p` のみ、`num_str` は後続（言語仕様/意味論決定後）に回す。
+- 許可する UpdateExpr:
+  - 文字連結パターン（`num_str = num_str + ch`）のみを許容するか。
+  - それ以外の文字列操作（substring/indexOf 等）は当面禁止するか。
+- 依存する箱:
+  - CarrierUpdateEmitter が文字列連結を安全に扱えるか（型/ValueId の整合）。
+  - ExprLowerer/MethodCallLowerer で文字列メソッドが必要か。
+
+## 3. テストで固定したいこと（候補）
+- 正常系: `"42"` → `num_str == "42"`, `p == len`, RC/ログ従来通り。
+- 非digit混在: `"7z"` → break で `num_str == "7"`, RC/ログ従来通り。
+- 既存の JsonParser スモークがあればそれを JoinIR 経路で回して差分が出ないことを確認。
+
+## 4. 進め方（小タスク案）
+1) UpdateExpr の whitelist を決める（文字連結のみ/その他禁止）。
+2) CarrierInfo に `num_str` を入れるかどうかを設計メモに明記。
+3) どのテストで意味論を固定するかを列挙（既存/新規）。
+4) これらを決めてからコード側 Phase 245B（小変更）に着手する。
+
+## 5. メモ
+- Phase 245-EX では `p` のみ JoinIR Pattern2 に載せた。`num_str` の扱いは未決。
+- 文字列キャリアは ValueId/ExitLine との整合が崩れやすいので、Fail-Fast 原則を崩さずに小さく導入すること。
--- a/docs/development/current/main/phase245b-num_str-carrier-design.md
+++ b/docs/development/current/main/phase245b-num_str-carrier-design.md
@ -0,0 +1,304 @@
+# Phase 245B: num_str Carrier Design Document
+
+**Status**: Design Phase
+**Target**: `_parse_number` loop の `num_str` 文字列キャリア対応
+**Scope**: Pattern 2 (loop with break) + 既存インフラ活用
+
+---
+
+## 1. num_str の役割
+
+### 1.1 現在の `_parse_number` ループ構造
+
+```nyash
+fn _parse_number(s, p) {
+    local num_str = ""
+    local len = s.length()
+    loop(p < len) {
+        local ch = s.substring(p, p + 1)
+        if not _is_digit(ch) {
+            break
+        }
+        num_str = num_str + ch   // ← StringAppend carrier update
+        p = p + 1
+    }
+    return num_str  // or return { num_str, p }
+}
+```
+
+### 1.2 num_str の役割定義
+
+| 観点 | 決定 |
+|------|------|
+| **主目的** | digit を連結する文字列バッファ |
+| **スコープ** | `_parse_number` 専用（245B では） |
+| **共有可能性** | 将来 `_atoi` / `_atof_loop` と共通化可能 |
+| **初期値** | 空文字 `""` |
+| **更新パターン** | Append のみ（削除・置換なし） |
+
+### 1.3 将来の拡張候補（245B では非対象）
+
+- `_atoi`: `num_str` → `result: Integer` への変換ループ
+- `_atof_loop`: 小数部・指数部を含む浮動小数点パース
+- これらとの整合性は **Phase 246+** で検討
+
+---
+
+## 2. 許可する UpdateExpr パターン
+
+### 2.1 最小セット（245B 対象）
+
+```
+num_str = num_str + ch
+```
+
+| 要素 | 制約 |
+|------|------|
+| **左辺** | `num_str`（LoopState carrier） |
+| **右辺** | `BinaryOp(Add, num_str, ch)` のみ |
+| **ch** | body-local または captured 変数 |
+
+### 2.2 許可パターンの形式定義
+
+```rust
+// 許可: num_str = num_str + ch
+UpdatePattern::StringAppend {
+    carrier: "num_str",
+    append_source: Variable("ch"),
+}
+
+// 内部表現
+BinaryOp {
+    op: Add,
+    lhs: Variable { name: carrier_name },  // 同じキャリア
+    rhs: Variable { name: append_var },    // body-local/captured
+}
+```
+
+### 2.3 非対象パターン（将来フェーズ候補）
+
+| パターン | 理由 | 候補フェーズ |
+|----------|------|-------------|
+| `ch + num_str` | 逆順 concat | Phase 246 |
+| `num_str + num_str` | 自己 concat | Phase 247 |
+| `a + b + c` | 三項以上 | Phase 247 |
+| `num_str.append(ch)` | MethodCall | Phase 248 |
+
+### 2.4 CarrierUpdateEmitter への統合案
+
+**Option A**: 既存 UpdateExpr に `StringConcat` variant 追加
+
+```rust
+pub enum UpdateExpr {
+    // 既存
+    Increment { carrier: String, amount: i64 },
+    Accumulate { carrier: String, source: ValueId },
+
+    // 新規追加 (245B)
+    StringAppend { carrier: String, append_source: String },
+}
+```
+
+**Option B**: Generic `BinaryUpdate` で統一
+
+```rust
+pub enum UpdateExpr {
+    BinaryUpdate {
+        carrier: String,
+        op: BinaryOperator,
+        rhs: UpdateRhs,
+    },
+}
+
+pub enum UpdateRhs {
+    Variable(String),
+    Constant(ConstValue),
+    Carrier(String),
+}
+```
+
+**推奨**: Option A（最小変更、明示的）
+
+---
+
+## 3. num_str キャリアの Contract / Invariant
+
+### 3.1 Loop Entry Contract
+
+```
+PRE:
+  - num_str = "" (空文字で初期化済み)
+  - p = 開始位置 (valid index)
+  - s = 対象文字列 (immutable)
+```
+
+### 3.2 Loop Iteration Invariant
+
+```
+INV:
+  - num_str = s[start_p..p] の digit 部分文字列
+  - p は monotonic increasing (p' > p)
+  - num_str.length() == p - start_p
+```
+
+### 3.3 Loop Exit Contract
+
+```
+POST (break):
+  - num_str = parse された digit 列
+  - p = 最初の non-digit 位置
+  - num_str == s[start_p..p]
+
+POST (natural exit):
+  - num_str = s[start_p..len] 全て digit
+  - p == len
+```
+
+### 3.4 ExitMeta 構造
+
+```rust
+ExitMeta {
+    exit_values: vec![
+        ("p".to_string(), p_final),           // loop counter
+        ("num_str".to_string(), num_str_final), // string carrier
+    ],
+}
+```
+
+---
+
+## 4. テストケース
+
+### 4.1 E2E テスト（正常系）
+
+| 入力 | 期待 num_str | 期待 RC |
+|------|-------------|---------|
+| `"0"` | `"0"` | 0 |
+| `"42"` | `"42"` | 0 |
+| `"123456"` | `"123456"` | 0 |
+| `"007"` | `"007"` | 0 (先頭 0 許容) |
+
+### 4.2 E2E テスト（部分マッチ系）
+
+| 入力 | 期待 num_str | 期待 p | 備考 |
+|------|-------------|--------|------|
+| `"7z"` | `"7"` | 1 | 1文字で break |
+| `"123abc"` | `"123"` | 3 | 3文字で break |
+| `"abc"` | `""` | 0 | 即 break |
+
+### 4.3 JoinIR 構造テスト
+
+```rust
+#[test]
+fn test_parse_number_string_carrier() {
+    // Given: _parse_number loop
+    // When: JoinIR generated
+    // Then:
+    //   - num_str is in CarrierInfo with role=LoopState
+    //   - UpdateExpr::StringAppend for num_str exists
+    //   - ExitMeta contains num_str exit value
+}
+```
+
+### 4.4 UpdateExpr 検証テスト
+
+```rust
+#[test]
+fn test_string_append_update_expr() {
+    // Given: num_str = num_str + ch
+    // When: UpdateExpr extracted
+    // Then:
+    //   - UpdateExpr::StringAppend { carrier: "num_str", append_source: "ch" }
+    //   - Exactly 1 StringAppend for num_str
+}
+```
+
+---
+
+## 5. 制約と非目標
+
+### 5.1 Phase 245B の制約
+
+| 制約 | 理由 |
+|------|------|
+| `_parse_number` のみ対象 | スコープ限定、段階的実装 |
+| 新パターン追加なし | P2 + 既存インフラ活用 |
+| by-name hardcode 禁止 | CarrierInfo/UpdateExpr で区別 |
+| StringAppend 1形式のみ | 最小セットから開始 |
+
+### 5.2 非目標（245B では実装しない）
+
+- `_atoi` / `_atof_loop` との共通化
+- Pattern 3/4 への文字列キャリア拡張
+- MethodCall 形式の append (`num_str.append(ch)`)
+- 逆順 concat (`ch + num_str`)
+- 三項以上の concat
+
+### 5.3 後続フェーズ候補
+
+| フェーズ | 内容 |
+|---------|------|
+| **246** | `_atoi` / `_atof_loop` との整合性 |
+| **247** | Pattern 3/4 に文字列キャリア拡張 |
+| **248** | MethodCall append 対応 |
+| **249** | 逆順・三項 concat 対応 |
+
+---
+
+## 6. 実装ロードマップ
+
+### 6.1 Phase 245B-1: UpdateExpr 拡張
+
+1. `UpdateExpr::StringAppend` variant 追加
+2. CarrierUpdateEmitter に StringAppend 検出ロジック
+3. ユニットテスト 3-5 件
+
+### 6.2 Phase 245B-2: CarrierInfo 統合
+
+1. String 型キャリアの role=LoopState 対応
+2. ExitMeta に string carrier 含める
+3. Header/Exit PHI に string value 通す
+
+### 6.3 Phase 245B-3: Pattern 2 統合
+
+1. `loop_with_break_minimal.rs` で StringAppend 処理
+2. E2E テスト実装
+3. `_parse_number` テストケース通す
+
+### 6.4 完了条件
+
+- [ ] `cargo build --release` 成功
+- [ ] 全テスト PASS（911+）
+- [ ] `_parse_number` E2E 4+ ケース PASS
+- [ ] UpdateExpr::StringAppend ユニットテスト PASS
+- [ ] by-name hardcode なし
+
+---
+
+## 7. リスク評価
+
+| リスク | 影響度 | 軽減策 |
+|--------|--------|--------|
+| String PHI の型不整合 | 中 | 既存 String carrier テスト確認 |
+| UpdateExpr 検出失敗 | 中 | 段階的検出ロジック |
+| Pattern 2 退行 | 低 | 911 テスト PASS 維持 |
+| 将来の拡張困難 | 低 | Option A 設計で拡張可能 |
+
+---
+
+## 8. 承認チェックリスト
+
+- [ ] num_str の役割（Section 1）確認
+- [ ] UpdateExpr パターン（Section 2）確認
+- [ ] Contract/Invariant（Section 3）確認
+- [ ] テストケース（Section 4）確認
+- [ ] 制約と非目標（Section 5）確認
+- [ ] 実装ロードマップ（Section 6）確認
+
+**承認後、Phase 245B-1 実装開始！**
+
+---
+
+*Document created: Phase 245B Design*
+*Author: Claude Code Session*
+*Date: 2025-12-11*
--- a/docs/development/current/main/phase245c-function-param-capture-summary.md
+++ b/docs/development/current/main/phase245c-function-param-capture-summary.md
@ -0,0 +1,254 @@
+# Phase 245C: Function Parameter Capture - Implementation Summary
+
+**Status**: ✅ COMPLETE
+**Date**: 2025-12-11
+**Scope**: Extend CapturedEnv to include function parameters used in loop conditions/body
+
+## 🎯 Goal
+
+Resolve `Variable not found: s` and similar errors by capturing function parameters (like `s`, `len`) that are used in loop conditions but not declared as pre-loop locals.
+
+## 📋 Background
+
+### Problem
+`analyze_captured_vars_v2` only captured pre-loop local variables with safe constant initialization. Function parameters used in loop conditions (e.g., `p < len` where `len` is a function parameter) were not captured, causing "Variable not found" errors in ExprLowerer.
+
+### Example Case
+```nyash
+method _parse_number(s, p, len) {
+    loop(p < len) {          // 'len' is a function parameter
+        local ch = s.charAt(p)  // 's' is a function parameter
+        p = p + 1
+    }
+}
+```
+
+Previously:
+- ❌ `len` not captured → "Variable not found: len" error
+- ❌ `s` not captured → "Variable not found: s" error
+
+Now:
+- ✅ Both `len` and `s` captured and available in ConditionEnv
+
+## 🛠️ Implementation
+
+### Step 1: Helper Function - `collect_names_in_loop_parts`
+
+**File**: `src/mir/loop_pattern_detection/function_scope_capture.rs`
+**Lines**: 668-745
+
+Added a helper function to collect all variable names used anywhere in loop condition and body:
+
+```rust
+fn collect_names_in_loop_parts(condition: &ASTNode, body: &[ASTNode]) -> BTreeSet<String>
+```
+
+Features:
+- Recursively walks condition and body AST
+- Collects all `Variable` node names
+- Returns deduplicated set using `BTreeSet` (deterministic iteration)
+- Handles all AST node types: If, Assignment, BinaryOp, MethodCall, etc.
+
+### Step 2: Extend `analyze_captured_vars_v2`
+
+**File**: `src/mir/loop_pattern_detection/function_scope_capture.rs`
+**Lines**: 372-412
+
+Added Phase 245C logic after pre-loop local processing:
+
+```rust
+// Phase 245C: Capture function parameters used in loop
+let names_in_loop = collect_names_in_loop_parts(loop_condition, loop_body);
+let pre_loop_local_names: BTreeSet<String> =
+    pre_loop_locals.iter().map(|(name, _)| name.clone()).collect();
+
+for name in names_in_loop {
+    // Skip if already processed as pre-loop local
+    if pre_loop_local_names.contains(&name) { continue; }
+
+    // Skip if in pinned/carriers/body_locals
+    if scope.pinned.contains(&name)
+        || scope.carriers.contains(&name)
+        || scope.body_locals.contains(&name) { continue; }
+
+    // Skip if reassigned in function
+    if is_reassigned_in_fn(fn_body, &name) { continue; }
+
+    // Capture as function parameter
+    env.add_var(CapturedVar {
+        name: name.clone(),
+        host_id: ValueId(0), // Resolved later in ConditionEnvBuilder
+        is_immutable: true,
+    });
+}
+```
+
+### Step 3: Fix Loop Index Handling
+
+**Lines**: 284-301
+
+Fixed issue where empty `fn_body` (common in unit tests) would cause early return:
+
+```rust
+// Before: Returned empty CapturedEnv if loop not found
+let loop_index = find_loop_index_by_structure(fn_body, loop_condition, loop_body);
+
+// After: Continue processing even if loop not found
+let pre_loop_locals = if let Some(idx) = loop_index {
+    collect_local_declarations(&fn_body[..idx])
+} else {
+    collect_local_declarations(fn_body)  // Still collect from fn_body
+};
+```
+
+## ✅ Testing
+
+### New Tests (4 tests added)
+
+**File**: `src/mir/loop_pattern_detection/function_scope_capture.rs`
+**Lines**: 1205-1536
+
+1. **`test_capture_function_param_used_in_condition`** (Lines 1205-1272)
+   - Case: `loop(p < len)` where `len` is a function parameter
+   - Expected: `len` captured in CapturedEnv
+   - Result: ✅ PASS
+
+2. **`test_capture_function_param_used_in_method_call`** (Lines 1274-1362)
+   - Case: `loop(p < s.length())` and `s.charAt(p)` where `s` is a function parameter
+   - Expected: `s` captured (used in both condition and body)
+   - Result: ✅ PASS
+
+3. **`test_capture_function_param_reassigned_rejected`** (Lines 1364-1442)
+   - Case: Function parameter reassigned in function body
+   - Expected: NOT captured (violates immutability requirement)
+   - Result: ✅ PASS
+
+4. **`test_capture_mixed_locals_and_params`** (Lines 1444-1535)
+   - Case: Mix of pre-loop locals (`digits`) and function params (`s`, `len`)
+   - Expected: All three captured
+   - Result: ✅ PASS
+
+### Test Results
+```
+running 12 tests
+test ... test_capture_function_param_used_in_condition ... ok
+test ... test_capture_function_param_used_in_method_call ... ok
+test ... test_capture_function_param_reassigned_rejected ... ok
+test ... test_capture_mixed_locals_and_params ... ok
+test ... (8 other existing tests) ... ok
+
+test result: ok. 12 passed; 0 failed
+```
+
+### Overall Suite
+```
+test result: ok. 923 passed; 1 failed; 56 ignored
+```
+
+Note: The 1 failure (`test_expr_lowerer_methodcall_unknown_method_is_rejected`) is pre-existing and unrelated to Phase 245C changes.
+
+## 🎯 Capture Criteria (Updated)
+
+A variable is captured if ALL of the following are met:
+
+### Pre-Loop Locals (Phase 200-B)
+1. Declared before the loop in function scope
+2. Safe constant init (string/integer literal only)
+3. Never reassigned in function
+4. Referenced in loop condition or body
+5. Not in pinned/carriers/body_locals
+
+### Function Parameters (Phase 245C - NEW)
+1. Used in loop condition or body
+2. NOT a pre-loop local (checked first)
+3. NOT in pinned/carriers/body_locals
+4. Never reassigned in function (immutability)
+
+## 📊 Integration with Pattern 2
+
+**File**: `src/mir/builder/control_flow/joinir/patterns/pattern2_with_break.rs`
+**Lines**: 166-222
+
+Pattern 2 already integrates `analyze_captured_vars_v2`:
+```rust
+let captured_env = if let Some(fn_body_ref) = fn_body {
+    analyze_captured_vars_v2(fn_body_ref, condition, _body, &scope)
+} else {
+    CapturedEnv::new()
+};
+
+// Add captured variables to ConditionEnv
+for var in &captured_env.vars {
+    if let Some(&host_id) = self.variable_map.get(&var.name) {
+        let join_id = join_value_space.alloc_param();
+        env.insert(var.name.clone(), join_id);
+        condition_bindings.push(ConditionBinding { ... });
+    }
+}
+```
+
+With Phase 245C, this now includes function parameters automatically!
+
+## 🔍 Example Before/After
+
+### Before Phase 245C
+```
+[ERROR] Variable not found: s
+[ERROR] Variable not found: len
+```
+
+### After Phase 245C
+```
+[pattern2/capture] Phase 200-C: Captured 2 variables
+[pattern2/capture]   's': host_id=ValueId(0), immutable=true
+[pattern2/capture]   'len': host_id=ValueId(0), immutable=true
+[pattern2/capture] Phase 201: Added captured 's': host=ValueId(42), join=ValueId(101)
+[pattern2/capture] Phase 201: Added captured 'len': host=ValueId(43), join=ValueId(102)
+```
+
+## 📝 Implementation Notes
+
+### Design Decisions
+
+1. **No `is_safe_const_init` check for function parameters**
+   Function parameters don't have initialization expressions in the loop's function body, so we don't apply the "safe constant init" check. They're considered safe if never reassigned.
+
+2. **Process pre-loop locals first**
+   This ensures we don't double-capture variables that are both function parameters and have local redeclarations.
+
+3. **Deterministic iteration with BTreeSet**
+   Uses `BTreeSet` instead of `HashSet` to ensure consistent capture order across runs.
+
+4. **Graceful handling of empty fn_body**
+   Unit tests often don't provide fn_body context. The implementation handles this by processing all variables in the loop without pre-loop local filtering.
+
+### Invariants Maintained
+
+- ✅ No duplicate captures (pre-loop locals checked before params)
+- ✅ Immutability requirement enforced (reassigned variables excluded)
+- ✅ Scope exclusions respected (pinned/carriers/body_locals)
+- ✅ Placeholder `host_id` (resolved later in ConditionEnvBuilder)
+
+## 🎉 Success Criteria - ALL MET
+
+- [x] `cargo build --release` succeeds
+- [x] All new tests PASS (4/4)
+- [x] All existing function_scope_capture tests PASS (12/12)
+- [x] No regressions in main test suite (923 passed)
+- [x] Function parameters captured in CapturedEnv
+- [x] Integration with Pattern 2 working
+
+## 🔗 Related Phases
+
+- **Phase 200-A**: CapturedEnv infrastructure
+- **Phase 200-B**: Pre-loop local capture
+- **Phase 200-C**: Structural matching variant (v2 API)
+- **Phase 245-EX**: JsonParser `_parse_number` JoinIR integration
+- **Phase 245B**: (Future) String carrier handling for `num_str`
+
+## 📌 Next Steps
+
+Phase 245C is complete. Next phases can now:
+1. Use function parameters in loop conditions without "Variable not found" errors
+2. Build on this for JsonParser `_parse_number` integration
+3. Extend to other JsonParser loops (`_atoi`, `_parse_array`, etc.)