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:
2025-12-23 11:14:28 +09:00
parent bf6f4faa1f
commit 41d92bedb9
15 changed files with 1600 additions and 259 deletions

View File

@ -1,6 +1,6 @@
# Phase 282: Router Shrinkage (pattern番号の症状ラベル化)
Status: Planned (design-first)
Status: Active SSOT / ✅ P0P9a 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 ...`)、アーキテクチャ SSOTFrag composition が SSOT
**Detection 戦略**簡潔版、詳細は P2+ で補完:
- **ExtractionBased**Pattern6/7/8/9: extract() 成功 → matchSSOT 単一)
- 注: 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_*() 成功 → matchSSOT 単一)
- 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
Pattern15 の extractor が持っていた “再帰カウント/検出/条件ヘルパ” の重複を、pure helper に集約する。
- 追加: `src/mir/builder/control_flow/joinir/patterns/extractors/common_helpers.rs`
- 方針:
- **SSOT=extract** は維持(判定は各 pattern extractor の責務)
- helper は purebuilder 触らない)・**silent fallback を作らない**
- Pattern3 の “if-else PHI” は専用ロジックが多いため、段階的に扱うP9b 以降)
- router に “経路ログ” を追加既定OFF、debugのみに限定
- pattern番号ではなく “entrypointPlan/JoinIR” をログの主語にする