refactor(extractors): Phase 282 P9a - CommonExtractionHelpers SSOT統合(スコープ限定版)
# Phase 282 P9a 完了 (Scope-Limited Integration) ## 実装内容 - **common_helpers.rs 作成**: 4グループの共通ヘルパー統合 (316行) - Group 1: Control Flow Counting (count_control_flow - 汎用カウンター) - Group 2: Control Flow Detection (has_break/continue/return_statement) - Group 3: Condition Validation (extract_loop_variable, is_true_literal) - Group 4: Pattern5専用ヘルパー (validate_continue_at_end, validate_break_in_simple_if) - **Pattern統合完了**: Pattern5 → Pattern4 → Pattern2 → Pattern1 - Pattern5: ~90行削減 (5 tests PASS) - Pattern4: ~66行削減 (5 tests PASS) - Pattern2: ~67行削減 (4 tests PASS) - Pattern1: ~28行削減 (3 tests PASS) - Pattern3: 別フェーズに延期(pattern固有ロジック除外) ## 成果 - **コード削減**: ~251行(Pattern3除く、total ~400行見込み) - **テスト**: 40 unit tests PASS (23 common_helpers + 17 extractors) - **スモークテスト**: 45 PASS, 1 pre-existing FAIL(退行ゼロ) - **ビルド警告**: 130 → 120 (-10) ## USER CORRECTIONS適用済み 1. ✅ スコープ限定(共通ロジックのみ、pattern固有除外) 2. ✅ Placeholder禁止(SSOT違反排除) 3. ✅ 統合順序変更(Pattern3を最後/別フェーズへ) ## 追加ドキュメント - Phase 284 計画追加(Return as ExitKind SSOT) - 10-Now.md, 30-Backlog.md 更新 🎯 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
@ -1,6 +1,6 @@
|
||||
# Phase 282: Router Shrinkage (pattern番号の症状ラベル化)
|
||||
|
||||
Status: Planned (design-first)
|
||||
Status: Active SSOT / ✅ P0–P9a complete (2025-12-23)
|
||||
|
||||
Goal:
|
||||
- pattern番号(Pattern1/2/…)を “症状ラベル(テスト名)” に縮退させ、router の責務を「抽出の配線」へ収束させる。
|
||||
@ -57,10 +57,42 @@ CFG構築は以下に収束させる:
|
||||
- ✅ 正しい用途: テスト名(`loop_if_phi.hako` → Pattern3_WithIfPhi)、debug ログ
|
||||
- ❌ 禁止: CFG 分岐(`if pattern == 6 then ...`)、アーキテクチャ SSOT(Frag composition が SSOT)
|
||||
|
||||
**Detection 戦略**(簡潔版、詳細は P2+ で補完):
|
||||
- **ExtractionBased**(Pattern6/7/8/9): extract() 成功 → match(SSOT 単一)
|
||||
- 注: Pattern8/9 は JoinIR table 経由でも、can_lower 内部で extract を使って判定している(pattern_kind 依存ではない)
|
||||
- **StructureBased**(主に Pattern1-5): ctx.pattern_kind などの事前分類を使う(legacy、SSOT が二重になりやすい)
|
||||
**Detection 戦略**(Phase 282 P3-P7 migration 完了):
|
||||
- **ExtractionBased** (全Pattern統一): extract_*() 成功 → match(SSOT 単一)
|
||||
- Pattern1-5: Phase 282 P3-P7 で ExtractionBased 移行完了
|
||||
- Pattern6/7: Phase 273 Plan-based (extract_*_plan)
|
||||
- Pattern8/9: Phase 259/270 で既に ExtractionBased
|
||||
- pattern_kind: **safety valve のみ**(O(1) perf guard、検出ロジックではない)
|
||||
|
||||
### Pattern Detection SSOT Table (Phase 282 P3-P7 Complete)
|
||||
|
||||
**全Pattern統一ルール**:
|
||||
1. **SSOT = extract**: Extraction 関数が検出の唯一の真実(pattern_kind ではない)
|
||||
2. **Safety valve**: pattern_kind は O(1) 早期reject のみ(検出ロジックに使わない)
|
||||
3. **Re-extract**: lower() は必ず再extract して SSOT 強制(can_lower 通過を信じない)
|
||||
|
||||
| Pattern | SSOT Entrypoint | Safety Valve | Re-extract | Phase |
|
||||
|---------|-----------------|--------------|------------|-------|
|
||||
| **Pattern1** | `extractors/pattern1.rs::extract_*` | `pattern_kind==Minimal` | ✅ | P282 P3 |
|
||||
| **Pattern2** | `extractors/pattern2.rs::extract_*` | `pattern_kind==Basic` | ✅ | P282 P4 |
|
||||
| **Pattern3** | `extractors/pattern3.rs::extract_*` | `pattern_kind==WithIfPhi` | ✅ | P282 P5 |
|
||||
| **Pattern4** | `extractors/pattern4.rs::extract_*` | `pattern_kind==Carrier` | ✅ | P282 P6 |
|
||||
| **Pattern5** | `extractors/pattern5.rs::extract_*` | `pattern_kind==InfiniteEarlyExit` | ✅ | P282 P7 |
|
||||
| **Pattern6** | `pattern6_scan_with_init.rs::extract_scan_with_init_plan()` | (none, Plan-based) | ✅ | P273 P1 |
|
||||
| **Pattern7** | `pattern7_split_scan.rs::extract_split_scan_plan()` | (none, Plan-based) | ✅ | P273 P2 |
|
||||
| **Pattern8** | `pattern8_scan_bool_predicate.rs` (can_lower) | (none, ExtractionBased) | ✅ | P259 |
|
||||
| **Pattern9** | `pattern9_accum_const_loop.rs` (can_lower) | (none, ExtractionBased) | ✅ | P270 |
|
||||
|
||||
**pattern_kind の正しい使い方**:
|
||||
- ✅ **O(1) guard**: `if pattern_kind != Expected { return false }` (perf最適化)
|
||||
- ✅ **Debug logging**: `pattern_kind={:?}` (診断情報)
|
||||
- ❌ **検出ロジック**: `if pattern_kind == X then lower_X()` (禁止、SSOT違反)
|
||||
- ❌ **CFG 分岐**: `match pattern_kind { ... }` (禁止、extract が SSOT)
|
||||
|
||||
**移行完了状態** (Phase 282 P8):
|
||||
- すべての Pattern が extract_*() を SSOT として使用
|
||||
- pattern_kind は早期reject の補助にすぎない
|
||||
- lower() は必ず re-extract して SSOT 強制(二重検証)
|
||||
|
||||
**SSOT 参照**:
|
||||
- Frag composition: `src/mir/builder/control_flow/edgecfg/api/compose.rs`
|
||||
@ -119,6 +151,23 @@ extract_scan_with_init_plan() → Ok(None) for unsupported cases
|
||||
|
||||
## P1 (code, minimal) — 配線の可視化
|
||||
|
||||
## Follow-up (design-first): Return as ExitKind SSOT
|
||||
|
||||
移行期間中に一番 “ズレやすい” のは `return` まわりなので、pattern 個別実装へ散らさず、
|
||||
`ExitKind` + `compose::*` / `emit_frag()` に収束させる方針を別フェーズで扱う。
|
||||
|
||||
- 入口: `docs/development/current/main/30-Backlog.md`(Phase 284)
|
||||
|
||||
## P9a (refactor, behavior-preserving) — Extractor 重複削減(Common helpers)
|
||||
|
||||
Pattern1–5 の extractor が持っていた “再帰カウント/検出/条件ヘルパ” の重複を、pure helper に集約する。
|
||||
|
||||
- 追加: `src/mir/builder/control_flow/joinir/patterns/extractors/common_helpers.rs`
|
||||
- 方針:
|
||||
- **SSOT=extract** は維持(判定は各 pattern extractor の責務)
|
||||
- helper は pure(builder 触らない)・**silent fallback を作らない**
|
||||
- Pattern3 の “if-else PHI” は専用ロジックが多いため、段階的に扱う(P9b 以降)
|
||||
|
||||
- router に “経路ログ” を追加(既定OFF、debugのみに限定)
|
||||
- pattern番号ではなく “entrypoint(Plan/JoinIR)” をログの主語にする
|
||||
|
||||
|
||||
Reference in New Issue
Block a user