Files
hakorune/docs/development/current/main/30-Backlog.md
tomoaki e3dd1bbecb docs: Phase 263 P0 完了記録(Pattern2 fallback 修正)
- 10-Now.md: Phase 263 P0 完了記録を追加(最上部に配置)
- phase-263/README.md: 詳細な実装記録・検証結果を作成
- 30-Backlog.md: Phase 263+ planned 項目を追加
  - Pattern2 LoopBodyLocal promotion(seg)
  - PromoteDecision API hardening(構造で迷子防止)
- phase263_p0_pattern2_seg_vm.sh: smoke test スクリプト改善

検証結果:
- cargo test --lib: 1368/1368 PASS 
- quick smoke: 45/46 PASS  (大幅改善)
- Pattern2 が正しく abort することを確認
2025-12-21 10:39:48 +09:00

7.3 KiB
Raw Blame History

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

  • 収束方針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継続 + envif/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既定挙動不変
  • Phase 263+planned / refactor: Pattern2 PromoteDecision API hardening

    • ねらい: “Reject でも続行して後段で落ちる” を構造で不可能にする(迷子防止)
    • 形(最小):
      • PromoteStepBox::try_promote(...) -> Result<PromoteDecision, String>
      • PromoteDecision::{Promoted, NotApplicable, Freeze}
    • 受け入れ条件:
      • orchestrator が NotApplicable を受け取ったら Pattern2 を Ok(None) で抜けて fallbackSSOT
      • “Reject=continue” のような曖昧挙動がコードから消える
  • 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 化する