tomoaki/hakorune
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
4c98313b588ac270a10f31d4d39bb142ce6bdf22
hakorune/src/mir/builder/control_flow/joinir/patterns/policies
History

README.md

JoinIR Pattern Policies - ルーティング箱の責務

概要

このディレクトリには、Pattern認識とルーティング（policy決定）を行う「箱」が格納されています。

Policy箱の責務

ルーティング決定

  • 入力: LoopSkeleton、break条件、carrier情報
  • 出力: 適用可能なPattern（Pattern2, Pattern3, etc.）とLoweringResult
  • 判断基準: パターンマッチング条件（Trim, ConditionalStep, Escape, etc.）

Lowering Result生成

  • Pattern固有の情報（ConditionOnlyRecipe, ConditionalStepInfo, etc.）を生成
  • CarrierInfo拡張（promoted variables, trim_helper, etc.）
  • ConditionBinding設定

Policy箱の候補（将来の整理対象）

trim_loop_lowering.rs (Phase 180/92/93)

現在の場所: patterns/trim_loop_lowering.rs

責務: Trimパターン認識とConditionOnlyルーティング

判断基準:

  • LoopBodyLocal変数がTrim条件（whitespace check）
  • break条件がConditionOnly（毎イテレーション再計算）

出力:

  • TrimLoweringResult - condition, carrier_info, condition_only_recipe

将来的な整理:

  • Trimパターン判断ロジックをpolicies/へ移動検討
  • 現在はpatterns/直下に配置（Phase 180統合済み）

p5b_escape_derived_policy.rs (Phase 94)

現在の場所: patterns/policies/p5b_escape_derived_policy.rs

責務: P5b escapeパターン認識とBodyLocalDerivedルーティング

判断基準:

  • body-local変数の再代入（例: ch = s.substring(...)）
  • escape skip条件（例: if ch == "\\" { i = i + 2 }）
  • loop変数の条件付き更新

出力:

  • P5bEscapeDerivedDecision::UseDerived(BodyLocalDerivedRecipe) - escape recipe
  • P5bEscapeDerivedDecision::Reject(String) - 検出失敗理由
  • P5bEscapeDerivedDecision::None - 該当なし

将来的な整理:

  • policies/配下でpolicy箱として統一済み（Phase 96）

loop_true_read_digits_policy.rs (Phase 104/105)

現在の場所: patterns/policies/loop_true_read_digits_policy.rs

責務: loop(true) + break-only digits（read_digits_from family）の認識とルーティング

判断基準:

  • loop(true) である
  • read-digits(loop(true)) detector に一致する
  • ReadDigitsBreakConditionBox が eos 条件 + digit 条件を抽出できる

出力:

  • PolicyDecision::Use(LoopTrueReadDigitsPolicyResult) - break_when_true := (ch == \"\") || !(digit_cond) と ch allow-list
  • PolicyDecision::Reject(String) - 検出失敗理由（Fail-Fast）
  • PolicyDecision::None - 該当なし

body_local_policy.rs

現在の場所: patterns/body_local_policy.rs

責務: Body-local変数の昇格判断

判断基準:

  • body-local変数がloop carrier候補か
  • 昇格可能なパターンか（Trim, Escape, etc.）

将来的な整理:

  • policies/へ移動してpolicy箱として統一

設計原則

単一判断の原則

  • 各policy箱は1つのパターン判断のみ
  • 複数パターンの判断は別のpolicy箱に委譲

非破壊的判断

  • 入力を変更しない
  • 判断結果をResultで返す（Ok(Some(result)) / Ok(None) / Err(msg)）

Fail-Fast

  • パターンマッチング失敗は即座にOk(None)を返す
  • エラーは明示的にErr(msg)
  • Reject理由はerror_tags::freeze()でタグ付与

Decision型の統一

  • PolicyDecision<T>（Use / Reject / None）をSSOTにする
  • 例: P5bEscapeDerivedDecision = PolicyDecision<BodyLocalDerivedRecipe>, TrimPolicyResult

使用パターン

Pattern2ルーティング（現在のパターン）

// Step 1: P5b escapeパターン判断
match classify_p5b_escape_derived(body, loop_var_name) {
    P5bEscapeDerivedDecision::UseDerived(recipe) => {
        // P5b escape適用
        return lower_with_p5b_escape(recipe, ...);
    }
    P5bEscapeDerivedDecision::Reject(reason) => {
        return Err(reason);
    }
    P5bEscapeDerivedDecision::None => {
        // 次のパターンへ
    }
}

// Step 2: Trimパターン判断
if let Some(trim_result) = TrimLoopLowerer::try_lower_trim_pattern(...)? {
    // Trimパターン適用
    return Ok(trim_result);
}

// Step 3: デフォルトパターン
Ok(default_pattern2_lowering(...))

将来の統一パターン（policies/移動後）

use patterns::policies::{P5bEscapePolicy, TrimPolicy, ConditionalStepPolicy};

// Policy boxの統一インターフェース
trait PatternPolicy {
    type Decision;
    fn classify(&self, context: &PatternContext) -> Self::Decision;
}

// ルーティングパイプライン
let decision = P5bEscapePolicy.classify(&ctx)
    .or_else(|| TrimPolicy.classify(&ctx))
    .or_else(|| ConditionalStepPolicy.classify(&ctx))
    .unwrap_or(DefaultDecision);

デバッグ

ログprefixの統一

  • [policy/p5b-escape] - P5b escape判断
  • [policy/trim] - Trim判断
  • [policy/conditional-step] - ConditionalStep判断

環境変数

  • HAKO_JOINIR_DEBUG=1 - JoinIR全般のデバッグログ
  • joinir_dev_enabled() - 既存の制御機構

デバッグ出力例

if joinir_dev_enabled() {
    eprintln!("[policy/p5b-escape] Detected escape pattern: {:?}", info);
}

命名規則

ファイル命名

  • <パターン名>_policy.rs - パターン判断policy箱
  • 例: trim_policy.rs, escape_policy.rs, conditional_step_policy.rs

型命名

  • <パターン名>Decision - 判断結果型
  • <パターン名>Policy - policy箱の構造体（将来）

列挙型パターン

pub enum Decision {
    None,           // 該当なし
    Use(Recipe),    // 適用可能
    Reject(String), // 検出失敗
}

将来の拡張

Phase 95以降の候補

  • trim_policy.rs - Trimパターン判断をpolicies/へ移動
  • escape_policy.rs - P5b escapeを統一インターフェースに
  • array_loop_policy.rs - 配列ループパターン判断
  • map_loop_policy.rs - Mapループパターン判断
  • conditional_step_policy.rs - ConditionalStep独立箱化

段階的な移行計画

Phase 1: ディレクトリ準備（今回）

  • policies/ディレクトリ作成 ✅
  • README.md作成 ✅
  • mod.rs作成 ✅

Phase 2: 既存policy箱の移動（将来）

  • p5b_escape_derived_policy.rs → policies/escape_policy.rs
  • body_local_policy.rs → policies/body_local_policy.rs
  • trim関連ロジック抽出 → policies/trim_policy.rs

Phase 3: インターフェース統一（将来）

  • PatternPolicy trait定義
  • Decision型の統一
  • ルーティングパイプラインの実装

拡張時の注意

  • README.mdにpolicy箱の責務を追加
  • Decision型を統一パターンに従う
  • 既存のpolicy箱との一貫性を保つ
  • Fail-Fastタグを明記

参考資料

関連ドキュメント

Phase Log

設計哲学（Box Theory）

箱理論の適用

  • 箱にする: Policy判断を独立した箱に分離
  • 境界を作る: Decisionを統一インターフェースに
  • 戻せる: 段階的移行で既存コードを壊さない
  • 見える化: ログprefixで判断過程を可視化

Fail-Fast原則の徹底

  • フォールバック処理は原則禁止
  • Reject理由を明示的に返す
  • エラータグで根本原因を追跡可能に

単一責任の箱

  • 1つのpolicy箱 = 1つのパターン判断
  • 複数パターンの組み合わせは上位層で制御
  • policy箱同士は独立・疎結合