4169da8c33
Update documentation with refactoring results: **phase-131/README.md**: - Document all 7 refactoring tasks (1: MergeContracts, 2: instruction_rewriter boxification, 3-4: OutputContract + require_joinir_dev, 5: env.sh SSOT, 6: MergeConfig, 7: contract_checks tests) - Add task descriptions and success criteria - Document benefits and test results - Reference implementation files and commits **tools/build_llvm.sh**: - Use TARGET_TMPDIR from env.sh for TMPDIR configuration - Improve EXDEV mitigation for WSL compatibility - Better artifact finalization handling **Summary of Phase 131 Refactoring**: 7 refactoring tasks completed on schedule: ✅ Task 1 (MergeContracts): +30 lines, SSOT for merge contracts ✅ Task 2 (instruction_rewriter): +212 lines (policy box), -50 lines (rewriter) ✅ Task 3 (OutputContract): +90 lines, unified verification interface ✅ Task 4 (require_joinir_dev): +14 lines, dev-only helper ✅ Task 5 (env.sh SSOT): +1014 lines, centralized environment ✅ Task 6 (MergeConfig): +54 lines, unified configuration ✅ Task 7 (contract_checks tests): +116 lines, 4 new tests Total: ~2500 new lines, 0 regressions, all tests PASS Benefits: - Code organization: Single responsibility principle - Maintainability: SSOT reduces duplication - Testability: Policy boxes and unit tests enable regression detection - Developer experience: Clearer code, better documentation Related: Phase 131 P1.5-P2 DirectValue exit reconnection + infrastructure improvement 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
Phase ドキュメント
このフォルダは、実装フェーズ（Phase 131, Phase 33 等）ごとの詳細記録を保管します。
現在の Phase
- Phase 132: Exit Values Parity (VM == LLVM)
- Phase 133: Promoted carrier join_id（Trim）修正
- Phase 134: Plugin loader best-effort loading
- Phase 135: ConditionLoweringBox allocator SSOT（ValueId 衝突の根治）
- Phase 136: MirBuilder Context SSOT 化（+ ValueId allocator 掃討）
- Phase 137–141: Loop Canonicalizer（前処理 SSOT）導入（Phase 137 フォルダに統合して記録）
- Phase 91–92: Selfhost depth‑2 coverage（P5b escape recognition → lowering）
- Phase 94–100: P5b escape E2E / Trim policy / pinned + accumulator（VM/LLVM EXE parity）
- Phase 102: real-app read_quoted loop regression（VM + LLVM EXE）
- Phase 103: if-only regression baseline（VM + LLVM EXE / plan）
- Phase 113: if-only partial assign parity（片側代入の保持 merge）
- Phase 107–109: real-app depth-scan / policy router SSOT / error hint SSOT
- Phase 110–112: 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 (根本原因分析)
参照方法
- 現在の Phase を知りたい → ../10-Now.md
- 該当 Phase を詳しく知りたい → フォルダを開く
- 設計背景を知りたい → ../design/
- 調査ログを見たい → ../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-18