Files
hakorune/docs/development/current/main/phases
tomoaki 4496b6243d feat(joinir): Phase 259 P0 complete - Pattern8 final fixes + docs (pre-block-params migration)
Phase 259 P0: Pattern8 (BoolPredicateScan) 完全完了
is_integer/1 を Pattern8 で受理し、VM/LLVM EXE 両方で動作確認完了。
次の大工事(block-parameterized CFG への移行)前のマイルストーンとして記録。

## Key Fixes Applied

1. **skipped_entry_redirects** (instruction_rewriter.rs)
   - k_exit のスキップ時、entry block 参照を exit_block_id へリダイレクト
   - BasicBlockId not found エラーを根治

2. **loop_var_name** (pattern8_scan_bool_predicate.rs)
   - merge_entry_block 選択に使用(`Some(parts.loop_var.clone())`)
   - 未設定時の誤った entry block 選択を修正

3. **loop_invariants** (pattern8_scan_bool_predicate.rs)
   - PHI-free 不変量パラメータ(`[(me, me_host), (s, s_host)]`)
   - loop_var_name 設定時、BoundaryInjector が join_inputs Copy を全スキップするため必要
   - Pattern6 と同じ設計(header PHI で不変量を保持)

4. **expr_result** (pattern8_scan_bool_predicate.rs)
   - k_exit からの返り値を明示設定(`Some(join_exit_value)`)
   - Pattern7 style(推測ではなく明示)

5. **Smoke test scripts**
   - set +e パターンで exit code 7 をキャプチャ
   - LLVM EXE スクリプトにコメント追加(tools/build_llvm.sh 経由の明記)

## Contract Documentation

- join-explicit-cfg-construction.md に Pattern8 契約の具体例を追加
  - "pattern増でも推測増にしない" の実例として記録
  - loop_var_name / loop_invariants / expr_result / jump_args_layout の契約を明示
- 20-Decisions.md に正規化(Semantic/Plumbing)の分離方針を追記
- DOCS_LAYOUT.md に重要ドキュメントへの参照を追加

## Test Results

-  VM smoke test: `[PASS] phase259_p0_is_integer_vm` (exit 7)
-  LLVM EXE: tools/build_llvm.sh 経由で exit 7 確認
-  --verify: PASS

## Next FAIL (Phase 260+)

- Function: `Main.main/0` in `apps/examples/json_lint/main.hako`
- Error: `[cf_loop/pattern2] Failed to extract break condition from loop body`
- Pattern: Nested loop(外側 loop + 内側 loop with break)

🚀 次の大工事: block-parameterized CFG への移行を開始します。

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-21 03:21:22 +09:00
..
2025-12-17 04:26:23 +09:00
2025-12-17 04:26:23 +09:00
2025-12-17 04:26:23 +09:00
2025-12-17 23:30:13 +09:00
2025-12-17 23:30:13 +09:00
2025-12-17 23:45:55 +09:00
2025-12-18 02:39:44 +09:00
2025-12-18 02:55:14 +09:00
2025-12-18 05:50:29 +09:00
2025-12-18 06:47:43 +09:00

Phase ドキュメント

このフォルダは、実装フェーズPhase 131, Phase 33 等)ごとの詳細記録を保管します。

現在の Phase

  • Phase 139DONE: post-if post_k の return lowering を ReturnValueLowererBox に統一(出口 SSOT 完成)
  • Phase 140DONE: NormalizedExprLowererBox 初版pure expression のみ)
  • Phase 141 P0DONE: impure 拡張点contractを SSOT 化Call/MethodCall はまだ out-of-scope
  • Phase 141 P1DONE: “既知 intrinsic だけ” を許可して段階投入length0
  • Phase 141 P1.5DONE: known intrinsic registry + available_inputs 3-source merge + diagnostics
  • Phase 141 P2+planned: Call/MethodCall 対応effects + typing の段階投入)
  • Phase 142-loopstmt P0DONE: 正規化単位を statementloop 1個へ寄せるパターン爆発を止める
  • Phase 142-loopstmt P1DONE: LLVM EXE smoke同 fixtureを追加
  • Phase 143-loopvocabplanned: StepTree の語彙拡張loop 内 if/break/continue を「語彙追加」で吸収)
  • Phase 9192: Selfhost depth2 coverageP5b escape recognition → lowering
  • Phase 94100: P5b escape E2E / Trim policy / pinned + accumulatorVM/LLVM EXE parity
  • Phase 102: real-app read_quoted loop regressionVM + LLVM EXE
  • Phase 103: if-only regression baselineVM + LLVM EXE / plan
  • Phase 113: if-only partial assign parity片側代入の保持 merge
  • Phase 107109: real-app depth-scan / policy router SSOT / error hint SSOT
  • Phase 110112: ControlTree / StepTree構造SSOT, dev-only※設計SSOTは ../design/control-tree.md

Phase フォルダ構成(推奨)

phases/phase-131/
├── README.md                          (Phase 全体概要)
├── 131-03-llvm-lowering-inventory.md (LLVM 部分のテスト・検証)
├── 131-11-case-c-summary.md          (Case C 実装サマリー)
└── phase131-11-case-c-root-cause-analysis.md (根本原因分析)

参照方法

  1. 現在の Phase を知りたい../10-Now.md
  2. 該当 Phase を詳しく知りたい → フォルダを開く
  3. 設計背景を知りたい../design/
  4. 調査ログを見たい../investigations/

Phase 命名規則

  • ファイル名: phase-<N>-<title>/ (例: phase-131/)
  • 文書名: <N>-<NN>-<topic>.md (例: 131-11-case-c-summary.md)
    • Phase 番号で自然にソート可能
    • 同一 Phase 内で段階的に追跡可能

作成ルールSSOT

詳しくは ../DOCS_LAYOUT.md を参照。

  • 置き場所: phases/phase-<N>/ 配下のみ
  • 内容: Phase の実装記録・進捗・チェックリスト・検証結果
  • 避けるべき: 複数 Phase で参照される設計・アーキテクチャ(→ design/ へ)

最終更新: 2025-12-19