Files
hakorune/CURRENT_TASK.md

6.8 KiB
Raw Blame History

Current Task — Phase 20.34 (Concise)

This document is intentionally concise (≤ 500 lines). Detailed history and perphase plans are kept under docs/private/roadmap/. See links below.

Focus (now)

  • Keep quick profile green and stabilize verification on the Core route.
  • MiniVM (Hako) is kept, but canaries that were flaky are temporarily routed to Core for execution. MiniVM green will resume in Phase 20.36.
  • Prepare Phase 20.35 (MIR JSON v1 loader expansion) without changing default behavior.

Whats green (20.34)

  • Loop/PHI unify (phi_core) in JSON v0 bridge — unified path used (toggle exposed).
  • Program(JSON v0) PHItrace canaries — PASS.
  • Core exec canaries (builder → emit → Core) — now routed and PASS:
    • mirbuilder_internal_core_exec_canary_vm (rc=10)
    • mirbuilder_internal_loop_core_exec_canary_vm (rc=3)
    • mirbuilder_internal_loop_count_param_core_exec_canary_vm (rc=6)
    • mirbuilder_internal_loop_sum_bc_core_exec_canary_vm (rc=8)

Recent changes (summary)

  • Added MIR JSON v0 loader (minimal): src/runner/mir_json_v0.rs
    • Supports const/compare/branch/jump/phi/ret/copy
  • Promoted --mir-json-file to “execute + exit(rc)”
    • v1 → try_parse_v1_to_module; v0 → minimal loader; executes via Core interpreter
    • rc mapping unified in execute_mir_module_quiet_exit
  • verify_mir_rc improvements (tools/smokes/v2/lib/test_runner.sh)
    • Core primary: MIR(JSON) uses --mir-json-file, Program(JSON v0) uses --json-file
    • MiniVMhakovmrc==1 ヒューリスティックを削除し、経路評価を素直化v1はCore、v0はhakovmに整流
  • Hako JSON reader minor fix
    • lang/src/vm/core/json_v0_reader.hako: r# raw を通常文字列に統一Hako生文字列の互換性向上
  • MIR JSON v1 bridge extended
    • parse_const_value now handles f64/float, bool, string, and handle(StringBox) → ConstValue::String
    • Direct extern names supported in VM interpreter: env.mirbuilder.emit, env.codegen.emit_object
  • New v1 canaries (Core route)
    • tools/smokes/v2/profiles/quick/core/phase2035/v1_method_string_indexof_canary_vm.sh
    • tools/smokes/v2/profiles/quick/core/phase2035/v1_extern_mirbuilder_emit_canary_vm.sh
    • tools/smokes/v2/profiles/quick/core/phase2035/v1_method_string_substring_1arg_canary_vm.sh
    • tools/smokes/v2/profiles/quick/core/phase2035/v1_method_string_substring_2args_canary_vm.sh
    • tools/smokes/v2/profiles/quick/core/phase2035/v1_array_push_size_canary_vm.sh
    • (map) tools/smokes/v2/profiles/quick/core/phase2035/v1_map_set_get_size_canary_vm.sh
      • Note: returns size (1) for rc stability; get-path validated structurally

Open (pending)

  • なしv1 extern env.get/env.mirbuilder.emit/env.codegen.emit_object は provider で統一)

Active toggles (debug/verify)

  • NYASH_MIR_UNIFY_LOOPFORM=1|0
    • Default ON実装は統一経路のみ。OFF指定時は警告を出すが挙動は統一のまま
  • HAKO_VERIFY_PRIMARY=hakovm|core
    • 今回の flaky canary は core 側で実行検証のみ切替。MiniVM primary は Phase 20.36 で再挑戦。
  • NYASH_VM_TRACE_PHI=1 / HAKO_PHI_VERIFY=1 / NYASH_PHI_VERIFY=1
    • PHI 解析・観測(開発時のみ)

How to run (quick)

  • Build: cargo build --release
  • Program v0 PHItrace (debug):
    • SMOKES_ENABLE_DEBUG=1 bash tools/smokes/v2/profiles/quick/core/phase2034/program_v0_if_phi_trace_vm.sh
    • SMOKES_ENABLE_DEBUG=1 bash tools/smokes/v2/profiles/quick/core/phase2034/program_v0_loop_phi_trace_vm.sh
  • Core exec canaries20.34 緑対象):
    • bash tools/smokes/v2/profiles/quick/core/phase2034/mirbuilder_internal_core_exec_canary_vm.sh
    • bash tools/smokes/v2/profiles/quick/core/phase2034/mirbuilder_internal_loop_core_exec_canary_vm.sh
    • bash tools/smokes/v2/profiles/quick/core/phase2034/mirbuilder_internal_loop_count_param_core_exec_canary_vm.sh
    • bash tools/smokes/v2/profiles/quick/core/phase2034/mirbuilder_internal_loop_sum_bc_core_exec_canary_vm.sh

MiniVM policy20.34

  • 実装は維持alias/ret/phi 最小系を今後整える)。ただし quick の canary は Core へ寄せて緑化。
  • 20.36 で verify primary を hakovm に段階的に切替、MiniVM green を進める。

Next (20.35 — scoped; behavior unchanged)

  1. MIR JSON v1 loader expansionMethod/Extern/BoxCall — 最小)
    • callee.type=Method → BoxCall 復元box_name/method/receiver/args
    • callee.type=Extern → ExternCall 復元env.get/env.codegen.emit_object/env.mirbuilder.emit/console.log など)
    • effects 未指定は PURE 既定、WRITE 系は最小でフラグ化(実害ゼロ)
    • v1 canary 追加string indexOf/substring、array push/size、map set/get/size、extern env.get
  2. Using/alias の推移解決の堅牢化(深さ/循環/キャッシュ)
    • 実装済みDFS 深さ上限=10、循環検知、キャッシュ。strict では曖昧解決をエラー扱い。
  3. ドキュメント今回の経路Core/verifyを roadmap に反映DONE

Structure cleanups (20.35 A→B→C)

  • A) v1 mir_call 両対応flat/nested: 実装済(ローダで互換吸収)。
  • B) Extern provider 単一点化: 実装済handlers/extern_provider.rs。calls.rs/externals.rs から委譲。
  • C) Const パース共通化: 実装済src/runner/mir_json/common.rs。まず v1 から採用v0 は次段)。

Next (20.36 — verify primary → hakovm, preinclude removal, CABI scaffold)

  • Verify primary 切替(段階): hakovm → Core fallback
  • preinclude 非推奨化quick から撤去)
  • MiniVM の最小状態len/size/push の簡易 stateを flag ガードで導入デフォルトOFF— 導入済
  • 受信者別サイズ管理フラグ HAKO_VM_MIRCALL_SIZESTATE_PER_RECV=1 を導入canary 追加済)
  • HAKO_VM_MIRCALL_SIZESTATE=1 は緑化済push 2回→size=2。次は受信者別管理を flag で導入: HAKO_VM_MIRCALL_SIZESTATE_PER_RECV=1
  • CABI 設計docs + ヘッダ雛形)

Known open itemstracked to 20.36

  • MiniVM: using/alias の推移解決selfhost.vm.helpers.* 連鎖)
  • MiniVM: ret/phi の最小ケースで rc が確実に数値化されるよう整備(継続確認)

Roadmap linksperphase docs

  • Index: docs/private/roadmap/README.md
  • Phase 20.34: docs/private/roadmap/phases/phase-20.34/README.md
  • Phase 20.35: docs/private/roadmap/phases/phase-20.35/README.md
  • Phase 20.36: docs/private/roadmap/phases/phase-20.36/README.md

Appendix — Toggle quick reference

  • NYASH_MIR_UNIFY_LOOPFORM=1|0 … Loop/PHI 統一既定ON
  • HAKO_VERIFY_PRIMARY=hakovm|core … verify 実行経路(今は core 優先で緑化)
  • NYASH_VM_TRACE_PHI=1 … VM PHI 適用トレース
  • HAKO_PHI_VERIFY=1 | NYASH_PHI_VERIFY=1 … ビルダー側の PHI inputs 検証
  • HAKO_VM_PHI_STRICT=0互換:NYASH_VM_PHI_STRICT=0 … 実行時 PHI 厳格 OFF開発時のみ