docs: shrink now/backlog/current_task entrypoints

This commit is contained in:
2025-12-30 14:59:27 +09:00
parent e84739f0c0
commit 99c3a935bb
6 changed files with 2930 additions and 2882 deletions

View File

@ -1,442 +1,18 @@
# Self Current Task — Backlog (main)
Status: Active
Scope: 「次にやる候補」を短く列挙するメモ。現状`docs/development/current/main/10-Now.md` を入口にする
Related:
- `docs/development/current/main/10-Now.md`
- `docs/development/current/main/DOCS_LAYOUT.md`
Scope: 「次にやる候補」を短く列挙するメモ。入口`docs/development/current/main/10-Now.md`
## 直近JoinIR/selfhost
## Active
- **Phase 29an✅ COMPLETE: Skeleton/Feature FactsSSOT**
- 入口: `docs/development/current/main/phases/phase-29an/README.md`
- 状況: P0P14 ✅ 完了 / P15 closeout ✅
- Gate: `./tools/smokes/v2/profiles/integration/joinir/phase29ae_regression_pack_vm.sh`
- CorePlan migration: `docs/development/current/main/phases/phase-29ao/README.md`Next: P32
- **Phase 29aoactive: CorePlan composition from Skeleton/Feature**
- 入口: `docs/development/current/main/phases/phase-29ao/README.md`
- 状況: P0P31 ✅ 完了 / Next: P32Pattern2 real-world strict/dev shadow adopt
- Next 指示書: `docs/development/current/main/phases/phase-29ao/P32-STRICT-ADOPT-PATTERN2-REALWORLD-FROM-FACTS-INSTRUCTIONS.md`
## Near-Term Candidates
- **Phase 29af✅ COMPLETE: Boundary hygiene / regression entrypoint / carrier layout SSOT**
- 入口: `docs/development/current/main/phases/phase-29af/README.md`
- JoinIR regression gate SSOT: `docs/development/current/main/phases/phase-29ae/README.md`
- CorePlan hardening (docs-first): `docs/development/current/main/phases/phase-29al/README.md`
- CorePlan lowerer/verifier: `docs/development/current/main/phases/phase-29am/README.md`
- **Phase 29ag✅ COMPLETE: JoinIR merge SSOT unification**
- 入口: `docs/development/current/main/phases/phase-29ag/README.md`
## Archive
- **Phase 29ah✅ COMPLETE: JoinIR regression pack expansionreal-world coverage**
- 入口: `docs/development/current/main/phases/phase-29ah/README.md`
- **Phase 29ajcandidate: PlannerOutcome observability SSOT**
- 入口: `docs/development/current/main/phases/phase-29aj/README.md`
- 状況: P0/P1/P2/P3/P4/P5/P6/P7/P8/P9/P10 ✅ 完了
- Next: Phase 29aj P11TBD
- 運用: integration filter で phase143_* は回さないJoinIR 回帰は phase29ae pack のみ)
- 運用: phase286_pattern9_* は legacy pack (SKIP) を使う
- **Phase 29akcandidate: PlanRuleOrder SSOT + PlannerContext plumbing**
- 入口: `docs/development/current/main/phases/phase-29ak/README.md`
- 状況: P0/P1/P2/P3/P4/P5 ✅ 完了
- Next: Nonephase-29al へ)
- **Phase 29alcandidate: CorePlan composition hardening (docs-first)**
- 入口: `docs/development/current/main/phases/phase-29al/README.md`
- 状況: P0/P1/P2/P3 ✅ 完了docs-only
- Next: P4unwind を含む ExitKind 拡張: design only
- 道筋 SSOT: `docs/development/current/main/design/coreplan-migration-roadmap-ssot.md`
- **Phase 29am✅ COMPLETE: CorePlan Step-A implementation (lowerer/verifier)**
- 入口: `docs/development/current/main/phases/phase-29am/README.md`
- 状況: P0/P1/P2/P3 ✅ 完了
- Next: Phase 29an
- Gate: `./tools/smokes/v2/profiles/integration/joinir/phase29ae_regression_pack_vm.sh`
- **Phase 29aicandidate: Plan/Frag single-plannerFacts SSOT**
- 入口: `docs/development/current/main/phases/phase-29ai/README.md`
- Next: Phase 29ai P16TBD: promotion hint を JoinIR 側の orchestrator へ配線、挙動不変)
- **Phase 29ae P1✅ COMPLETE: JoinIR Regression Pack (SSOT固定)**
- 入口: `docs/development/current/main/phases/phase-29ae/README.md`
- **Phase 29ad✅ COMPLETE: Naming SSOT for Pattern6/7 fixtures**
- 入口: `docs/development/current/main/phases/phase-29ad/README.md`
- **Phase 29ac✅ COMPLETE: De-freeze Pattern6/7**
- 入口: `docs/development/current/main/phases/phase-29ac/README.md`
- **Phase 29ab✅ COMPLETE: JoinIR completion triage**
- 入口: `docs/development/current/main/phases/phase-29ab/README.md`
- **Phase 288✅ P0P3 + 288.1 complete: REPL mode**
- 入口: `docs/development/current/main/phases/phase-288/README.md`
- SSOT: `docs/reference/language/repl.md`
- 次: Phase 288.2+(任意): REPL UX improvementshistory / multiline / load 等)
- **Phase 287✅ COMPLETE: Developer Hygiene意味論不変**
- 状況: P0P9 ✅ 完了big files / facade / SSOT / docs guard / closeout
- 成果: merge/mod.rs (1,555→1,053行), ast_feature_extractor (1,148→135行), plan.rs (741→120行)
- 入口: `docs/development/current/main/phases/phase-287/README.md`
- **Phase 284✅ COMPLETE: Return as ExitKind SSOTpatternに散らさない**
- 目的: `return` を “pattern最適化の個別実装” にせず、`ExitKind``compose::*` / `emit_frag()` に収束させる
- ねらい: 移行期間中の「二重ルール」「検出の穴」を減らし、将来の pattern 増殖を防ぐ
- 入口: `docs/development/current/main/phases/phase-284/README.md`
- P0docs-only: `docs/development/current/main/phases/phase-284/P0-INSTRUCTIONS.md`
- SSOT:
- Composition: `src/mir/builder/control_flow/edgecfg/api/compose/mod.rs`
- Terminator emission: `emit_frag()``src/mir/builder/control_flow/edgecfg/api/emit.rs`
- Frag docs: `docs/development/current/main/design/edgecfg-fragments.md`
- 進め方:
- P0docs-onlyで “return の意味” と “Ok(None)/Err” の境界を固定
- P1+ で Rust/LLVM の実装を SSOT に収束pattern側に例外実装を増やさない
- **Phase 285✅ COMPLETE: Box lifecycle / weakref / finalization / GC SSOT**
- 目的: Box の生存期間(強参照/弱参照/解放/最終化)を SSOT として固定し、「実装が仕様」になっている箇所を潰す
- ねらい:
- VM 側の weakref/finalization を仕様化(テストで固定)
- LLVM harness 側の未対応/差分を “仕様として明文化” し、将来の実装計画を切る
- 入口: `docs/development/current/main/phases/phase-285/README.md`
- 状況(完了):
- P0/P1/P2 ✅ 完了weak 成功パターンは smoke 固定)
- P2.1 ✅ 完了: hidden root を根治し、weak-fail smoke を PASS に復帰
- P2.2 ✅ 完了: KeepAlive の二重責務を命令分離で解消(`KeepAlive`/`ReleaseStrong`
- P3.1/P3.2 ✅ 完了: LLVM 検出 + quick SSOT`--features llvm` でも quick の意味が変わらない)
- P4 ✅ 完了: `phase285_weak_basic_llvm` を PASS に復帰quick 154/154
- 参考(現状の入口候補):
- weakref 表現: `src/value.rs``NyashValue::WeakBox`
- finalization: `src/finalization.rs`
- 追加syntax cleanup, small & focused:
- `weak` の表面構文を `weak <expr>` に収束(`weak(<expr>)` を持ち込まない)
- `let weak w;` / `let weak w = e` の糖衣を検討(概念を増やさず `let w = weak e` にデシュガー)
- fixture/smoke は `apps/tests/*.hako` を SSOT にして VM/LLVM で共通化(必要なら LLVM 側は SKIP で理由を固定)
- **Phase 29y✅ P0 COMPLETE, docs-first SSOT finalized: MIR lifecycle vocab freezeRC/weak/ABI**
- 状況: P0 ✅ 完了docs-first SSOT finalized: ABI/RC insertion/Observability
- 成果: 3つのSSOT文書10/20/30Ready、pilot実装固定、Next steps明文化
- 入口: `docs/development/current/main/phases/phase-29y/README.md`
- 次: Phase 29zRC insertion minimalまたは Phase 29xDe-Rust runtime候補
- **Phase 29zP2 CLOSEOUT準備中, implementation-minimal: RC insertion minimal**
- 進捗: P1まで完了上書きStore nullReturn終端cleanup で ReleaseStrong 挿入、単一block・安全ガード付き
- ガード: Cargo feature `rc-insertion-minimal`既定OFF、env var 新設なし)
- 検証: quick 154/154 PASS 維持 + `rc_insertion_selfcheck`opt-in
- 残課題P2で方針化→次フェーズへ
- null伝搬の精度向上copy以外の伝搬パターン追加を段階的に
- Branch/Jump 終端での cleanup をどう安全に扱うかの設計
- PHI/loop/early-exit の安全な cleanup 設計誤release防止
- 入口: `docs/development/current/main/phases/phase-29z/README.md`
- 指示書: `docs/development/current/main/phases/phase-29z/P0-RC_INSERTION_MINIMAL-INSTRUCTIONS.md`
- **Phase 29aa✅ COMPLETE: RC insertion safety expansionCFG-aware**
- 進捗: P2 ✅ 完了Jump/Branch 終端で cleanup を入れない契約の SSOT 化)
- 進捗: P3 ✅ 完了Jump→Return single-predecessor state 伝播)
- 進捗: P4 ✅ 完了Jump-chain propagation to Return
- 進捗: P5 ✅ 完了Multi-predecessor Return join: state完全一致のみ
- 進捗: P6 ✅ 完了Multi-predecessor Return join: intersection
- 進捗: P7 ✅ 完了Deterministic ReleaseStrong ordering
- 進捗: P8 ✅ 完了Null propagation across CFG; Copy-only
- 入口: `docs/development/current/main/phases/phase-29aa/README.md`
- **Phase 29xplanned, post self-host: De-Rust runtime for LLVM execution**
- 目的: LLVM 実行経路のランタイム依存を段階的に Rust から切り離す脱Rust
- 前提: self-host ラインが安定し、VM/LLVM conformancePhase 285が十分に固まっていること。
- 方針:
- 仕様SSOTstrong/weak/fini/cleanup/voidは維持し、実装だけを差し替え可能にする。
- まず ABI 境界(例: `nyrt_*`)を “将来置換する契約” として固定し、独立ランタイムに差し替える。
- 受け入れ条件(最小):
- 既存の `apps/tests/*.hako` fixture を再利用し、VM/LLVM parity のスモークが維持される。
- weak の語彙(`weak <expr>` / `weak_to_strong()`が同じ意味で動作するcycleは当面リーク仕様でも可
- **Phase 29yplanned, post self-host / docs-first: MIR lifecycle vocab freezeRC/weak/ABI**
- 目的: 参照カウントstrong/weakを “どこで” 実装するかMIR語彙 vs runtime ABIを設計SSOT化し、脱Rust実装の土台にする
- 前提: self-host 後Phase 285weak conformance + hidden root 根治)が落ち着いていること
- 入口phase: `docs/development/current/main/phases/phase-29y/README.md`
- 入口(相談パケット): `docs/development/current/main/investigations/phase-29y-mir-lifecycle-vocab-consult.md`
- 進捗pilot, 仕様不変):
- docs SSOTABI/RC insertion/observabilityを phase-29y 配下に集約
- Phase 29y.1: “最小導線” の実装だけ先行(意味論は変更しない)
- NyRT handle ABI shim`crates/nyash_kernel/src/ffi/lifecycle.rs`
- RC insertion pass 入口no-op
- leak report に root categorieshandlesのみを追加Phase 1 limitation 明記)
- **Phase 286✅ complete: JoinIR Line AbsorptionJoinIR→CorePlan/Frag 収束)**
- 目的: 移行期間に残っている「2本の loweringPlan line / JoinIR line」を、構造で 1 本に収束させる
- ねらい: `return/break/continue` のような “大きな出口語彙” の実装場所が揺れない状態にする
- 入口: `docs/development/current/main/phases/phase-286/README.md`
- P0docs-only: `docs/development/current/main/phases/phase-286/P0-INSTRUCTIONS.md`
- 状況: Pattern19 の主要ループ形が Plan/Frag SSOT に吸収され、quick gate は green を維持。
- 将来の設計相談Phase 286 の範囲外で、別フェーズでSSOT化してから: `docs/development/current/main/investigations/phase-286-plan-normalization-consult.md`
- SSOT:
- Plan/Frag: `compose::*` + `emit_frag()`Phase 280/281
- JoinIR line 共通入口: `src/mir/builder/control_flow/joinir/patterns/conversion_pipeline.rs`
- (✅ done**Phase 282**: Router shrinkage + detection SSOT + extractor refactor
- 完了: `docs/development/current/main/phases/phase-282/README.md`
(✅ done**Phase 279 P0**: Type propagation pipeline SSOT 統一lifecycle / JoinIR / LLVM の二重化解消)
- 完了: `docs/development/current/main/phases/phase-279/README.md`
- **Phase 272✅ complete: Pattern6/7 を Frag+emit_frag へ吸収(段階適用)**
- 目的: scan系 loop の CFG 構築を `Frag/ExitKind` 合成へ寄せ、pattern列挙の増殖を止める
- 完了: P0.1Pattern6✅ + P0.2Pattern7
- 入口: fixture/smoke を SSOT として固定Pattern6→Pattern7 の順で段階適用)
- 詳細: `phases/phase-272/README.md`
- (✅ done**Phase 273**: Plan line SSOTPattern6/7
- 完了: `docs/development/current/main/phases/phase-273/README.md`
- (✅ done**Phase 280**: Frag composition SSOT positioning
- 完了: `docs/development/current/main/phases/phase-280/README.md`
- (✅ done**Phase 281**: compose adoptionPattern6/7, P0P3
- 完了: `docs/development/current/main/phases/phase-281/README.md`
- (✅ done**Phase 277/278**: PHI strict + env var 収束
- 完了: `docs/development/current/main/phases/phase-277/README.md`
- 完了: `docs/development/current/main/phases/phase-278/README.md`
- **Phase 274active, design-first: Type SSOT Alignmentlocal + dynamic runtime**
- 入口SSOT: `docs/reference/language/types.md`
- P1✅完了: Rust VM が `TypeOp(Check/Cast)` を実行可能(`is/as` が動く)
- P2✅完了: LLVM ラインllvmlite harness`TypeOp` を SSOT に合わせる
- P3decision: truthiness / equality / compare / `+` の coercion を SSOT として固定(必要なら “仕様変更フェーズ” を追加)
- 詳細: `phases/phase-274/README.md`
- **Phase 270✅ 完了): JoinIR-only minimal loop SSOT**
- `apps/tests/phase270_p0_loop_min_const.hako` + VM smoke で “最小 const loop” を固定exit=3
- Pattern1 は test-only stub のため不適合 → Pattern9AccumConstLoopを橋渡しとして追加
- 詳細: `phases/phase-270/README.md`
- **Phase 271✅ 完了, docs-only: Bridge pattern 撤去条件SSOT**
- 対象: bridge pattern例: `Pattern9_AccumConstLoop`
- 目的: 「汎用化しない」「Frag 合成へ吸収して削除する」を SSOT 化
- 成果物:
- `docs/development/current/main/design/edgecfg-fragments.md``Bridge patterns撤去条件SSOT` に “bridge contract” テンプレを追加
- `Pattern9_AccumConstLoop` の撤去条件fixture/smoke/手順)を同セクションに明文化
- SSOT: `docs/development/current/main/design/edgecfg-fragments.md`
- **Phase 269 P1✅ 完了): Pattern8 を EdgeCFG で実装SSA を閉じる)**
- 方針: emission 入口で Frag 構築break/continue 無しなので `compose::loop_()` は使わず手配線)
- 完了: header に `i` の PHI を追加して SSA を閉じた(`i_current = phi [i_init, preheader], [i_next, step]`
- early-exit の `return false` は Return wire、`return true` は loop 後 AST に任せる
- Pattern8 の返り値は当面 `void`loop-statement 扱い)
- 補足DONE: static box の `this/me` は MethodCall 共通入口で static call に正規化済みPattern8 は現状 static box 文脈を対象外)
- 詳細: `phases/phase-269/README.md`
- **Phase 270+planned: Pattern6/7 への Frag 適用**
- Pattern6: Match scanindex_of 系)
- Pattern7: Split scansplit 系)
- 統一的なループ処理パターン確立
- Pattern 分岐削減
- **収束方針SSOT案: Expr/Condition/Control の 3 箱分割**
- ExprLowererBox式SSOT: `AST(expr)``(prelude, value)`ANF含む。pure/impure/whitelist/strict を集約入口SSOT
- ConditionLowererBox条件→分岐SSOT: `AST(cond)``BranchPlan`。評価順は ExprLowererBox に委譲し、`&&/||` は制御語彙で扱う。
- ControlLowererBox制御SSOT: `StepNode/ControlTree` → JoinIR継続 + env`if/loop` を担当し、条件は ConditionLowererBox に委譲。
- **Phase 141 P2+planned: Call/MethodCalleffects + typing を分離して段階投入)**
- ねらい: pure/impure 境界を壊さずに、impure lowering を段階投入する。
- 前提DONE:
- Phase 141 P1.5: known intrinsic allowlist + available_inputs 3-source merge + diagnostics
- 受け入れ条件:
- out-of-scope は `Ok(None)` でフォールバック(既定挙動不変)
- effects の順序付けは SSOT で固定してから解禁by-name 増殖禁止)
- **Phase 144-anfplanned: impure 式導入の順序固定ANF**
- ねらい: `x + f(y)` 等の “pure + impure 混在” で評価順が仕様になる前に、ANF で順序固定を SSOT 化する
- 入口: `docs/development/current/main/phases/phase-144-anf/INSTRUCTIONS.md`
- 受け入れ条件:
- impure を lowering できない場合は `Ok(None)` でフォールバック(既定挙動不変)
- dev/strict では「順序固定の欠落」を Fail-Fast診断に順序ログを含める
- **Phase 143-loopvocab R0planned: Contract SSOT 抽出refactor P0 → modular components**
- 目的: loop_true_if_break_continue.rs を「検出/契約/変換」に分割し、P1/P2 での if分岐増殖を防ぐ
- 実装:
- 新ファイル: `src/mir/control_tree/normalized_shadow/common/loop_if_exit_contract.rs`
- `enum LoopIfExitThen { Break, Continue }`
- `struct LoopIfExitShape { has_else: bool, then: LoopIfExitThen, else_: Option<LoopIfExitThen>, cond_scope: ExprLoweringScope }`
- `enum OutOfScopeReason { NotLoopTrue, BodyNotSingleIf, ThenNotExit, ElseNotSupported, CondOutOfScope(...) }`
- Refactor: loop_true_if_break_continue.rs は「shape抽出 → lower」だけに縮退SSOT は contract側
- Tests: unit test を dedicated module へ分離test maintainability
- 受け入れ条件:
- cargo check ✅no errors
- P1/P2 での if分岐を防ぐcontract で決定性を保証)
- out-of-scope は `Ok(None)` で一貫(既定挙動不変)
- **Phase 143-loopvocab P1planned: continue 語彙追加**
- 対象: `loop(true) { if(cond_pure) continue }` を same lowering に通す
- 実装:
- LoopIfExitShape で `LoopIfExitThen::Continue` を許可
- JoinModule: if true → loop_step (continue semantics)
- Fixtures: `phase143_loop_true_if_continue_min.hako`
- Smoke: VM + LLVM EXE
- Out-of-scope は `Ok(None)` のまま
DONEPhase 143-loopvocab P2: else 対称化B-C / C-B
- 記録: `docs/development/current/main/10-Now.md`
- **Phase 143-loopvocab P3+planned: impure conditions 対応**
- 目的: `if(cond_impure) break/continue` を ANF/順序固定の上で段階投入する
- 方針: Phase 145-anf の契約hoist + left-to-rightを条件式にも適用
- **Phase 263+planned: Pattern2 LoopBodyLocal promotionseg**
- 目的: StageB compilebundle_resolver系で露出している Pattern2 `LoopBodyLocal(seg)` を受理し、quick の first FAIL を進める
- 受け入れ条件:
- 最小再現 fixture + smoke で固定(先に失敗を SSOT 化)
- Pattern2 が不成立のときは “部分続行” せず `Ok(None)` で fallback既定挙動不変
- **DONEPhase 263 P0.2: Pattern2 PromoteDecision API hardening**
- 入口SSOT: `src/mir/builder/control_flow/joinir/patterns/pattern2/api/`
- `PromoteDecision::{Promoted, NotApplicable, Freeze}``try_promote(...)` に参照点を収束Option揺れを撤去
- **Phase 264✅ 入口作成完了): EdgeCFG Fragment 入口作成design-first**
- **ステータス**: ✅ 入口作成完了(適用は次フェーズ)
- **実装内容**:
- `edgecfg/api/` フォルダに SSOT 入口作成
- `ExitKind`, `EdgeStub`, `Frag` の型定義
- `seq`, `if_`, `loop_`, `cleanup` のシグネチャ固定pub(crate)
- 最小ユニットテスト 3個
- ドキュメント連動edgecfg-fragments.md
- **制約遵守**:
- 既存 pattern6/7/8 未改変
- merge/EdgeCFG 未改変
- cargo test -p nyash-rust --lib --no-run 成功確認
- **次フェーズへの橋渡し**:
- Phase 265 で Pattern8 適用時に `compose::loop_` を実装
- 再利用確認後、pattern番号分岐を段階的に削減
- **Phase 265 P0✅ 完了): compose/verify 最小実装**
- **目的**: 入口SSOTの形を固める迷子防止
- **実装**:
- compose::loop_() 最小実装exit集合分類のみ、配線なし
- verify_frag_invariants() 最小実装(デバッグガード付き)
- compose::loop_() ユニットテスト 2個追加
- **制約**:
- Pattern8 未改変P0では触らない、偽Frag回避
- 配線ロジックは P1 以降
- **次**: Phase 265 P1 で配線ロジック + Pattern8適用
- **Phase 265 P1✅ 完了): compose 配線ロジック実装**
- **目的**: Frag/ExitKind の配線能力を BasicBlockId 層で証明
- **実装**:
- EdgeStub.target 追加Option<BasicBlockId>
- compose::loop_() 配線ロジックContinue → header, Break → after
- verify_frag_invariants() 配線契約検証
- test-only PoC5個のテスト: 既存2個更新 + 新規3個追加
- **配線契約**:
- Continue(loop_id) の EdgeStub.target = Some(header)
- Break(loop_id) の EdgeStub.target = Some(after)
- Normal/Return/Unwind の EdgeStub.target = None上位へ伝搬
- **制約**:
- MIR 命令生成なしFrag 層のみ)
- NormalizedShadow 未適用Phase 267 に繰り越し)
- **(✅ 完了Phase 265 P2: seq/if_ 実装wires/exits 分離)**
- **目的**: 「解決済み配線wires」と「未解決 exitexits」を分離し、Frag 合成の基本パターンを完成
- **完了内容**:
- Frag に `wires: Vec<EdgeStub>` 追加
- wires/exits 分離設計確立exits = target None, wires = target Some
- loop_() を wires 対応に更新
- seq(a, b) 実装a.Normal → wires
- if_(header, cond, t, e, join_frag) 実装t/e.Normal → wires
- verify 強化wires/exits 分離契約、警告のみ)
- 全テスト PASS13個: frag 3 + compose 9 + verify 1
- **設計判断**:
- wires/exits 分離で再配線バグ防止
- if_ は join_frag: Frag で「join 以降」を明確化
- verify は警告のみErr 化は Phase 266 の strict 版で段階導入)
- **次**: Phase 266 で MIR 命令生成 PoCemit_wires、Phase 267 で NormalizedShadow/JoinIR へ実適用
- **(✅ 完了Phase 266: wires → MIR terminator 生成(最小 PoC**
- **目的**: wires を MIR terminator に変換する最小 PoC を実装し、Phase 267 での本格適用に備える
- **完了内容**:
- emit.rs 作成emit_wires 実装 + unit test 4個
- verify_frag_invariants_strict() 追加(段階導入を壊さない)
- Jump/Return 対応Branch は Phase 267
- mod.rs 更新emit module エクスポート)
- 全テスト PASS1392 passed: 既存 1388 + 新規 4個
- **核心原則**:
- from ごとにグループ化して1本だけ許可1 block = 1 terminator 制約)
- Return は target=None を許可(意味を持たない)
- verify_frag_invariants() は変更なし警告のまま、strict 版を別名で用意)
- Phase 260 terminator 語彙ルールを厳守
- **設計判断**:
- from グループ化で terminator 上書きバグ防止
- Return は target 不要(呼び出し元に戻る)
- verify strict 版で段階導入を壊さない
- **次**: Phase 267 で JoinIR Pattern への適用
- **(✅ P0 完了Phase 267: BranchStub + emit_fragBranch の第一級化)**
- **目的**: Frag に Branch を第一級で追加し、wiresJump/Returnと同様に MIR terminator へ落とす入口を作る
- **完了内容P0**:
- `BranchStub` 追加 + `Frag.branches` 追加
- `compose::if_` が header→then/else の BranchStub を生成
- `emit_frag(function, frag)` を追加(`emit_wires` + `set_branch_with_edge_args`
- 1 block = 1 terminatorwire/branch の衝突)を Fail-Fast
- unit tests + `cargo test -p nyash-rust --lib` PASS
- **P1延期**:
- "層を跨がない実適用"は候補が抽象化層へ委譲済みのため、Phase 268 で体系的に適用する方針
- **詳細**: `docs/development/current/main/phases/phase-267/README.md`
- **(✅ 完了Phase 268: if_form.rs への Frag 適用 + entry edge-args SSOT化**
- **目的**: EdgeCFG Fragment を層を跨がずに実戦投入し、compose::if_() の edge-args を SSOT 化
- **完了内容P0**:
- emission/branch.rs に emit_conditional_edgecfg() 追加(薄いラッパー)
- if_form.rs を Frag+emit_frag 経由に変更emit_conditional + emit_jump を削除)
- emission 層経由で層が綺麗に保たれる
- **完了内容P1**:
- compose::if_() シグネチャ変更then_entry_args, else_entry_args 追加)
- emission/branch.rs から空 EdgeArgs を渡す
- EdgeCFG テスト更新compose.rs 2箇所、emit.rs 1箇所
- TODO コメント削除完了Phase 267 P2+ TODO 解消)
- **テスト結果**:
- cargo build --release: 成功
- cargo test --lib --release: 1444/1444 PASS
- quick smoke: 45/46 PASS既存状態維持
- **核心原則**:
- emission 層経由で Frag 構築を MirBuilder 層から分離
- SSOT 原則: compose::if_() は edge-args を内部生成しない
- **次**: Phase 269 で Pattern6/7/8 への Frag 適用 + fixture/smoke test
- **詳細**: `docs/development/current/main/phases/phase-268/README.md`
- **real-app loop regression の横展開VM + LLVM EXE**
- ねらい: 実コード由来ループを 1 本ずつ最小抽出して fixture/smoke で固定する(段階投入)。
- 現状: Phase 107find_balanced_array/object / json_cur 由来)まで固定済み。
- 次候補: JsonLoader/JsonCur から 1 本ずつfixture + integration smokeで増やす。
- **P5b “完全E2E”**escape skip の実ループを end-to-end で固定)
- 現状: Phase 94 で VM E2E まで固定済み。次は selfhost 実コード(`apps/selfhost-vm/json_loader.hako`)へ横展開して回帰を減らす。
- 入口: `docs/development/current/main/phases/phase-94/README.md`
- **制御の再帰合成docs-only → dev-only段階投入**
- ねらい: `loop/if` ネストの "構造" を SSOTControlTree/StepTreeで表せるようにする
- 注意: canonicalizer は観測/構造SSOTまでValueId/PHI配線は Normalized 側へ)
- 現状: Phase 119128if-only Normalized: reads/inputs/unknown-read/partial-assign keep/mergeまで完了
- ✅ 完了: Phase 129-Cpost-if を post_k continuation で表現)
- 入口: `docs/development/current/main/design/control-tree.md`
## 中期(ループ在庫の残り)
- **P5guard-bounded**: 大型ループを “小粒度” に割ってから取り込む(分割 or 新契約)
- **P6nested loops**: capability guard で Fail-Fast 維持しつつ、解禁時の契約を先に固定
## 中期(制御の表現力)
北極星: `docs/development/current/main/design/join-explicit-cfg-construction.md`
設計メモ: `docs/development/current/main/design/exception-cleanup-async.md`
- **catch/cleanupInvoke**
- 追加語彙を `Invoke(ok_edge, err_edge)` に絞って例外 edge を明示する(例外値は edge-args で運ぶ)。
- 実装タイミング: Phase 260edge-args terminator 収束)の P1〜P2 以降が推奨。
- **cleanup/defercleanup normalizer**
- Return/Throw/Break/Continue を cleanup に寄せる “脱出 edge 正規化” を箱化するfinally の後継としての cleanup
- 実装タイミング: catch/cleanup の次(例外 edge も含めて正規化するため)。
- **async/awaitstate machine lowering**
- CFG語彙に混ぜず、AsyncLowerBox で state machine 化してから MIR に落とす。
- 実装タイミング: finally/defer の後cancel/drop と cleanup の接続を先に固める)。
## ドキュメント運用
- 重複が出たら「設計 SSOTdesign」に集約し、Phaseログphasesは “何をやったか/検証したか” に限定する
- 調査ログinvestigationsは結論を SSOT に反映してから Historical 化する
- 旧 backlog肥大化防止のためアーカイブ: `docs/development/current/main/phases/phase-29ao/30-Backlog-archive.md`