tomoaki/hakorune
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
30aa39f50b7408d55c5d179861f0638d333d0004
hakorune/CURRENT_TASK.md

15 KiB
Raw Blame History

Current Task — Phase 20.38 (Extern/C‑ABI bring‑up, Hako‑first verify)

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

Focus (now)

  • Extern/C‑ABI の最小導線（既定OFF）を整備し、Hakorune primary で emit/codegen を rc=0 ＋ 安定タグに固定。
  • v1 Dispatcher を IR 反復に切替（scan 依存を排除）、φテーブル適用の堅牢化（strict/tolerate）。
  • Verify 既定を v1→Hako（Core fallback）へ整流（段階）。
  • Using はテキスト統合（merge_prelude_text）に一本化、include は quick=ERROR（ハーネス方針と整合）。
  • 拡張子ポリシー（暫定）: .nyash→Nyash VM、.hako→Hakorune VM。詳細は docs/guides/source-extensions.md。

Remaining (20.38 — inline alias stabilization: updated)

  • Route: vm.rs に hv1 直行ルートを追加（HAKO_ROUTE_HAKOVM=1 かつ NYASH_VERIFY_JSON）。NyashParser を完全にバイパス。
  • Alias only: verify は alias のみで安定（include/preinclude は撤去・既定OFF）。
  • Safety sweep: “"" + ” の連結全廃（必要時のみ to-string）。

Hotfix Plan — Using/Prelude Unification (Self‑Host)

  • Problem: .hako を NyashParser に通す経路でパース落ち（Invalid expression）。
  • Decision: プレリュードは“テキスト統合（merge_prelude_text）”に一本化。AST マージは撤退。
    • Resolver 入口は共通（alias/modules/packages/builtin）。
    • 以降はメインの言語に応じて実行器へ渡す（Hako→Hakorune VM / MIR→Core）。
    • NyashParser は Nyash コードのみ。Hako は Nyash VM 経路に入れない（Fail‑Fast）。

Action Items (20.38)

  • P1 C‑ABI ブリッジ（既定OFF）
    • Hako provider→Rust extern_provider へ最小接続（emit/codegen）。
    • ハーネスのタグ用シム（test_runner）を撤去できる状態にする。
  • P2 v1 Dispatcher IR 完了＋φテーブル堅牢化
    • V1SchemaBox.get_function_ir を構造IRで返却（blocks/phi_table）。
    • ループは IR 反復に完全切替、φ は entry 適用（命令ループから除去）。
    • 複数φ/複数incoming/空白改行混在を canary で固定。
  • P3 Verify 既定整流（完了）
    • v1→Hakorune を既定ON、Core は診断 fallback。末尾数値抽出で rc を一意化。
    • include ポリシー quick=ERROR を維持（ドキュメントと一致）。
  • P4 Resolver/alias 仕上げ
    • lang/src/vm/** の alias を監査し、直参照を払拭。normalize/trace ログは最小に整流。
  • P5 Docs 反映
    • phase‑20.38 のトグル/受け入れ条件/撤去予定のシムを反映。φ entry SSOT は IR 完了後に更新。
    • extern タグ用シムの現状と撤去条件（hv1 inline 安定後に除去）を明記。

Acceptance

  • extern canary（warn/error/emit/codegen）: Hako primary で PASS（タグ＋rc=0、シム無効でも安定）。
  • v1 φ/branch/jump の代表カナリーが IR 反復で strict PASS。tolerate ケースは期待と一致。
  • Verify 既定が v1→Hakorune（Core fallback）で quick 緑維持。
  • Hako 構文を Nyash VM で実行しようとした場合、入口で Fail‑Fast（診断メッセージ）。

Changes (this step)

  • hv1 直行: vm.rs 冒頭で NYASH_VERIFY_JSON を検出し、JSON v1/v0→MIR→Core 実行（数値のみ出力）。
  • test_runner: hv1 verify は直行（$NYASH_BIN --backend vm /dev/null＋env JSON）。include fallback は dev 変数で明示時のみ。
  • v1 JSON Bridge: φ incoming を [pred,val] として正規化（Core parity）。
  • φ カナリー追加: multi-incoming3 / nested+sum / tolerate undefined→rc=0。
  • V1PhiAdapterBox: robust incoming scan (multi‑pair, spaces/newlines) using array‑end scanner.
  • V1SchemaBox: new block_segment_wo_phi(json, bid) to build IR segment without φ.
  • V1SchemaBox: phi_table_for_block(json,bid) 追加（dst と incoming[[pred,val],…] を返す）
  • NyVmDispatcherV1Box(FLOW): IR‑based loop（block_segment_wo_phi）＋ entry φ は V1PhiTableBox.apply_table_at_entry で一括適用（scan は後退互換のfallbackに）
  • Entry φ application: still centralized in V1PhiTableBox; added optional trace hooks (HAKO_V1_FLOW_TRACE=1).
  • Canary updated to enable experiment flag: v1_hakovm_phi_simple_flow_canary_vm.sh sets HAKO_V1_ALLOW_PHI_EXPERIMENT=1.
  • φ canaries 追加: multi‑incoming / multi‑phi / whitespace混在 → いずれも PASS
  • v1 extern canaries（20.38）: env.get / warn / error / emit / codegen を PASS 化（タグ＋rc=0）。
  • hv1 inline prelude: prelude_v1.hako を path‑using に切替（inline -c での alias 揺れ回避）。
  • phase2038 hv1 inline canary ドライバは ALLOW_USING_FILE を付与し、preinclude で安定化を準備（現状は alias 未解決で SKIP）。
  • extern stub canaries（emit/codegen）: include 依存を撤去し、rc=0 のみ確認に簡素化（タグ観測は hv1 inline カナリーへ委譲）。
  • test_runner の provider タグ用シムを撤去（hv1 inline が安定したため）。
  • vm.rs に hv1 ルーティング口を追加（opt-in、Fail‑Fast 緩和下で NYASH_VERIFY_JSON の inline を hv1 wrapper にルート）。
  • verify は env（NYASH_VERIFY_JSON）受け渡し＋末尾数値抽出で rc を安定化。
  • Dispatcher(FLOW) は構造IRの反復へ完全切替（scan断片を撤去）。
  • V1Schema.get_function_ir: blocks/phi_table 構築を実装（op/text＋一部フィールド抽出で dispatcher の負荷低減）。

What’s green (20.34)

  • Loop/PHI unify (phi_core) in JSON v0 bridge — unified path used (toggle exposed).
  • Program(JSON v0) PHI‑trace 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
    • Mini‑VM（hakovm）rc==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

  • 20.38 extern bring-up (Hakorune primary)

    • Hakorune provider tags: prints [extern/c-abi:mirbuilder.emit] / [extern/c-abi:codegen.emit_object] when HAKO_V1_EXTERN_PROVIDER_C_ABI=1（既定OFF）
    • Core extern provider: when HAKO_V1_EXTERN_PROVIDER=1, env.mirbuilder.emit / env.codegen.emit_object return empty string (stub) to keep rc=0（verify fallbackの安定化）
    • Dispatcher(FLOW): minor cleanup to avoid stray scanning code; ret-path returns value and does not emit trailing prints
    • Canaries: phase2038 emit/codegen → PASS（タグ＋rc=0 を固定）。phi 追加ケース（then→jump combo3）も PASS。

Open (pending)

  • P1〜P4 の実装・緑化（上記 Action Items）。

Active toggles (debug/verify)

  • HAKO_VERIFY_PRIMARY=hakovm|core（既定 hakovm、Coreは診断）
  • HAKO_V1_DISPATCHER_FLOW=1（v1 FLOW 実行）
  • HAKO_V1_EXTERN_PROVIDER=1（Hako extern provider 有効）
  • HAKO_V1_EXTERN_PROVIDER_C_ABI=1（タグ/ブリッジ実験。既定OFF）
  • HAKO_V1_PHI_STRICT=1 / HAKO_V1_PHI_TOLERATE_VOID=1（φポリシー）
  • NYASH_RESOLVE_TRACE=1 / NYASH_RESOLVE_NORMALIZE=1（resolver dev）

How to run (quick)

  • Build: cargo build --release
  • Program v0 PHI‑trace (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 canaries（20.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

Mini‑VM policy（20.34）

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

Next (20.35 — scoped; behavior unchanged)

  1. MIR JSON v1 loader expansion（Method/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, C‑ABI scaffold)

  • Verify primary 切替（段階）: hakovm → Core fallback
  • preinclude 非推奨化（quick から撤去）
  • Mini‑VM の最小状態（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
  • C‑ABI 設計（docs + ヘッダ雛形）

Known open items（tracked to 20.36）

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

Next (20.37 — v1 Dispatcher & Phi)

  1. V1SchemaBox: get_function_ir(JSON→IR) を拡張（blocks/insts/phi_table を一括）
  2. NyVmDispatcherV1Box: IR反復へ切替（スキャナ依存の最終撤去）、今は二重化（IR優先/scan後退互換）
  3. Resolver/inline: AST prelude マージで推移usingを一次収束（Claude codeで進行）、ランナーは既存fallback維持

Next (Hotfix — Using/Prelude Unification)

  1. vm.rs: using_ast 経路を merge_prelude_text に一本化（ASTマージ撤去）
  2. vm.rs: Hako 構文検出で Hakorune VM へ切替（NyashParser をバイパス）
  3. strip.rs: .hako の AST パース抑止と診断ガイド
  4. verify: extern canary を PASS 化（末尾 rc 抽出の安定化） Docs:
  • docs/development/architecture/phi-entry-in-hako.md に φ entry 設計のSSOTを記載（不変条件/flags/テスト）

Next (20.38 — extern provider & C‑ABI)

  1. HakoruneExternProviderBox を拡張（warn/error/emit の最小タグ/空文字挙動）— 完了
  2. HAKO_V1_EXTERN_PROVIDER=1 の canary 追加（構造緑固定）— 完了
  3. C‑ABI 導線のPoC接続（emit/codegen、既定OFF）— 完了（タグ＋rc=0）
  4. hv1 inline 安定化（残）: -c 経路の using resolver に modules.workspace を強制ロードするか、dispatcher の using を dev 限定で path 化。
  5. include 撤去の計画（dev → 本線）：
    • まず stub カナリーの include は撤去済み（rc=0 のみ確認）。
    • hv1 inline カナリーの prelude include は暫定（dev専用）。-c/alias 安定後に alias へ移行して include を撤去する。
    • ランナー側では merge_prelude_text を既定経路とし、include は quick=ERROR のポリシーを維持。

Roadmap links（per‑phase 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（開発時のみ）

Updates (2025-11-04)

  • hv1 inline: alias-only route stabilized (no include/preinclude). vm.rs wrapper now uses using selfhost.vm.hv1.dispatch and relaxes fail-fast for child.
  • Verify harness: include+preinclude fallback for v1 removed in verify_mir_rc; alias-only hv1 is the standard path.
  • Concat-safety (hv1 scope): replaced "" + <int> coercions with StringHelpers.int_to_str(...) in lang/src/vm/hakorune-vm/dispatcher_v1.hako and lang/src/vm/boxes/mir_call_v1_handler.hako.