hakorune/docs/development/current/main/phases/phase-256/README.md

Phase 256: StringUtils.split/2 Pattern Support

Status: Planning Scope: Loop pattern recognition for split/tokenization operations Related:

• Phase 255 完了（loop_invariants 導入、Pattern 6 完成）
• Phase 254 完了（Pattern 6 index_of 実装）

失敗詳細

テスト: json_lint_vm (quick profile) エラー: [joinir/freeze] Loop lowering failed: JoinIR does not support this pattern 関数: StringUtils.split/2

エラーメッセージ全体

[trace:dev] loop_canonicalizer:   Decision: FAIL_FAST
[trace:dev] loop_canonicalizer:   Missing caps: [ConstStep]
[trace:dev] loop_canonicalizer:   Reason: Phase 143-P2: Loop does not match read_digits(loop(true)),
    skip_whitespace, parse_number, continue, parse_string, or parse_array pattern
[ERROR] ❌ MIR compilation error: [joinir/freeze] Loop lowering failed: JoinIR does not support this pattern,
    and LoopBuilder has been removed.
Function: StringUtils.split/2
Hint: This loop pattern is not supported. All loops must use JoinIR lowering.

期待される動作

StringUtils.split(s, separator) が正常にコンパイルされ、文字列分割が動作すること。

実際の動作

Loop canonicalizer が ConstStep を要求しているが、このループはステップが複雑で定数ではない。

最小再現コード

split(s, separator) {
    local result = new ArrayBox()

    // Early return for empty separator
    if separator.length() == 0 {
        result.push(s)
        return result
    }

    local start = 0
    local i = 0

    // Main scan loop
    loop(i <= s.length() - separator.length()) {
        if s.substring(i, i + separator.length()) == separator {
            result.push(s.substring(start, i))
            start = i + separator.length()
            i = start  // Variable step - moves by separator.length()
        } else {
            i = i + 1  // Constant step - moves by 1
        }
    }

    // Push remaining segment
    if start <= s.length() {
        result.push(s.substring(start, s.length()))
    }

    return result
}

分析

ループ構造

1. 条件: i <= s.length() - separator.length()
2. ボディ:
   • If branch: マッチング検出時
     • result.push() でセグメント追加
     • start = i + separator.length() で次の開始位置更新
     • i = start で大きくジャンプ（可変ステップ）
   • Else branch: マッチなし
     • i = i + 1 で 1 進む（定数ステップ）
3. 特徴:
   • 可変ステップ: マッチング時は separator.length() 分ジャンプ
   • 複数キャリア: i, start, result を更新
   • MethodCall: substring(), push(), length() を使用

Canonicalizer の問題

Missing caps: [ConstStep]

• 既存の Pattern 1-6 は定数ステップを想定
• このループは条件分岐で異なるステップ幅を使う
• Pattern 2 (balanced_depth_scan) に近いが、可変ステップがネック

実装計画

Option A: Pattern 7 - Split/Tokenization Pattern

新しいパターン追加:

• 可変ステップサポート
• 複数キャリア（i, start, accumulator）
• If-else での異なるステップ幅処理

検出条件:

1. Loop condition: i <= expr - len
2. Body has if statement:
   • Then: i = something_big (可変ジャンプ)
   • Else: i = i + 1 (定数ステップ)
3. Accumulator への追加操作 (push など)

Option B: Pattern 2 拡張

既存 Pattern 2 を拡張:

• ConstStep 要件を緩和
• If-else で異なるステップ幅を許可
• balanced_depth_scan_policy を拡張

Option C: Normalization 経路

ループ正規化で対応:

• 可変ステップを定数ステップに変換
• Carrier 追加で状態管理

次のステップ

1. StepTree 詳細解析: split ループの完全な AST 構造確認
2. 類似パターン調査: 他の可変ステップループ（indexOf, contains など）
3. Option 選択: Pattern 7 新設 vs Pattern 2 拡張 vs Normalization
4. 実装戦略策定: 選択した Option の詳細設計

備考

• Phase 255 で loop_invariants が導入されたが、このケースは invariants 以前の問題（可変ステップ）
• Phase 254-256 の流れで Pattern 6 → Pattern 7 の自然な進化が期待される
• split/tokenization は一般的なパターンなので、汎用的な解決策が望ましい