hakorune/docs/development/current/main/30-Backlog.md

# 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`

## 直近（JoinIR/selfhost）

- **Phase 141 P2+（planned）: Call/MethodCall（effects + 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 143-loopvocab R0（planned）: 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 P1（planned）: 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)` のまま

- **Phase 143-loopvocab P2（planned）: else 対応（break/continue 対称化）**
  - 対象: `if(cond){break}else{continue}` と `if(cond){continue}else{break}` を追加
  - 実装:
    - LoopIfExitShape で `has_else=true` + symmetric `then/else_` を許可
    - Contract で 4パターンを明示（P0: no-else, P1: no-else+continue, P2: with-else）
    - Fixtures: 2本（対称ケース）
    - Smoke: VM/LLVM EXE
  - 完了で「語彙として完成」に寄せる

- **real-app loop regression の横展開（VM + LLVM EXE）**
  - ねらい: 実コード由来ループを 1 本ずつ最小抽出して fixture/smoke で固定する（段階投入）。
  - 現状: Phase 107（find_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` ネストの "構造" を SSOT（ControlTree/StepTree）で表せるようにする
  - 注意: canonicalizer は観測/構造SSOTまで（ValueId/PHI配線は Normalized 側へ）
  - 現状: Phase 119–128（if-only Normalized: reads/inputs/unknown-read/partial-assign keep/merge）まで完了
  - ✅ 完了: Phase 129-C（post-if を post_k continuation で表現）
  - 入口: `docs/development/current/main/design/control-tree.md`

## 中期（ループ在庫の残り）

- **P5（guard-bounded）**: 大型ループを “小粒度” に割ってから取り込む（分割 or 新契約）
- **P6（nested loops）**: capability guard で Fail-Fast 維持しつつ、解禁時の契約を先に固定

## ドキュメント運用

- 重複が出たら「設計 SSOT（design）」に集約し、Phaseログ（phases）は “何をやったか/検証したか” に限定する
- 調査ログ（investigations）は結論を SSOT に反映してから Historical 化する