tomoaki
519e58a977
P0: Documentation SSOT (~80 lines added)
- Router Responsibilities SSOT (DOES/DOESN'T split)
- Ok(None)/Err boundary rules (Fail-Fast principle)
- Entrypoint table (Plan/JoinIR/None, 収束先明記)
- Pattern番号 = 症状ラベル定義（最小記述）
P1: Minimal Code (~10 lines)
- 4 trace statements modified (router.rs)
- Entrypoint-based logging (route=plan/joinir/none)
- Pattern names preserved (backward compatible)
- No new environment variables (既存trace機構のみ)
Test Results:
- quick profile: 45 PASS / 1 FAIL (既知failure)
- Pattern6 VM: PASS (phase258_p0_index_of_string_vm.sh)
- Pattern6 LLVM: PASS (phase258_p0_index_of_string_llvm_exe.sh)
- Zero regression ✅
Phase 282 Goal Achieved:
- Router shrinkage complete (SSOT positioning clear)
- Pattern numbers → symptom labels transition documented
- CFG construction converges to emit_frag() SSOT
Phase ドキュメント
このフォルダは、実装フェーズ（Phase 131, Phase 33 等）ごとの詳細記録を保管します。
現在の Phase
- Phase 139（DONE）: post-if
post_kの return lowering をReturnValueLowererBoxに統一（出口 SSOT 完成） - Phase 140（DONE）:
NormalizedExprLowererBox初版（pure expression のみ） - Phase 141 P0（DONE）: impure 拡張点（contract）を SSOT 化（Call/MethodCall はまだ out-of-scope）
- Phase 141 P1（DONE）: “既知 intrinsic だけ” を許可して段階投入（length0）
- Phase 141 P1.5（DONE）: known intrinsic registry + available_inputs 3-source merge + diagnostics
- Phase 141 P2+（planned）: Call/MethodCall 対応（effects + typing の段階投入）
- Phase 142-loopstmt P0（DONE）: 正規化単位を statement（loop 1個）へ寄せる（パターン爆発を止める）
- Phase 142-loopstmt P1（DONE）: LLVM EXE smoke（同 fixture）を追加
- Phase 143-loopvocab（planned）: StepTree の語彙拡張（loop 内 if/break/continue を「語彙追加」で吸収）
- 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-19