tomoaki/hakorune
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
ae84391a954a742e65f3a2a5f85faafaa39b775a
hakorune/docs/private/roadmap/phases/phase-20.5/PLAN.md

4.4 KiB
Raw Blame History

Phase 20.5 — Gate Plan (脱Rust 大作戦)

Status: Active Scope: Minimal, verifiable, gate‑based execution plan

Executive Summary (5 lines)

  • Goal: Escape from Rust by bootstrapping a self‑hosting Hakorune line.
  • Strategy: Freeze Rust (v1.1‑frozen) and build upward in small, verifiable gates.
  • Shape: Parser → MIR → (Pure VM Foundations) with HostBridge as the only external boundary.
  • Proof: Deterministic outputs, parity, and fixed‑point (v1==v2==v3) where applicable.
  • Policy: Keep changes minimal, deterministic, and test‑first (SKIP when preconditions unmet).

Gates (must pass in order)

  • Gate A: Parser v1 (Hakorune) produces canonical AST JSON
    • DoD: ~10 cases PASS; no non‑determinism; keys sorted
    • Implemented CLI: --dump-ast-json (stdout), --emit-ast-json <file> (pre‑macro)
    • Smokes (quick‑selfhost):
      • parser_ast_json_canonical_vm.sh, parser_ast_json_return_vm.sh, parser_ast_json_unary_vm.sh
      • parser_ast_json_array_literal_vm.sh, parser_ast_json_map_literal_vm.sh
      • parser_ast_json_empty_array_vm.sh, parser_ast_json_empty_map_vm.sh
      • parser_ast_json_if_else_vm.sh, parser_ast_json_emit_file_vm.sh
    • MirIoBox normalize（guarded by HAKO_JSON_CANON）: mirio_canonicalize_vm.sh
  • Gate B: MIR Builder v1 (Hakorune) emits minimal MIR (16 ops)
    • Scope (P1): const, ret, binop(Add/Sub/Mul/Div/Mod), compare(Eq/Ne/Lt/Le/Gt/Ge), jump, branch
    • DoD: 16 ops reachable; quick-selfhostで4本の代表スモークPASS（不足はSKIPガードで段階導入）
    • Smokes (quick-selfhost):
      • mir_builder_const_ret_vm.sh（const→ret）
      • mir_builder_binop_add_vm.sh（const,const→binop(Add)→ret）
      • mir_builder_compare_eq_vm.sh（compare(Eq)→branch→then/else→ret）
      • mir_builder_compare_lt_vm.sh（compare(Lt)→branch→then/else→ret）
    • Status（2025-10-23）:
      • Stage‑1 default/vararg/named 混在を Fail‑Fast 化（NYASH_PIPELINE_V2=1 gate、selfhost_pipeline_v2_stage1_invalid_args_fail_vm.sh）。
      • selfhost 系スモークは SMOKES_SELFHOST_ENABLE=1 で opt-in（既定では quick/integration から除外）。
  • Gate C: VM Foundations (Pure Hakorune) — 5 ops PoC via HostBridge
    • Ops: const, binop, compare, jump, ret
    • DoD: Simple programs run end‑to‑end; measurable performance
    • CLI entry (thin wiring):
      • --nyvm-json-file <path> → read MIR(JSON v0) and execute via HakoruneVmCore.run_from_file
      • --nyvm-pipe → read MIR(JSON v0) from stdin and execute via HakoruneVmCore.run
  • Gate D: op_eq Migration (NoOperatorGuard + 8 types)
    • DoD: 20 golden tests PASS; ≥70% perf vs Rust‑VM
  • Gate E: Integration & Docs
    • DoD: E2E 10 cases PASS; docs complete; CI minimal green

Note: C Code Generator track is preserved as design reference but not primary; Pure Hakorune VM is the active plan.

Minimal Instruction Set (Phase 20.5 scope)

  • Values/control: const, ret
  • Arithmetic: binop(Add/Sub/Mul/Div/Mod)
  • Compare: Eq/Ne/Lt/Le/Gt/Ge (boolean 0/1)
  • Control: jump, branch
  • Phi: pre‑compute lowering (block‑local temps)

Determinism & DoD

  • Canonicalize JSON (sorted keys), stable whitespace/newlines
  • No timestamps/PIDs/randomness/hash iteration variance
  • DoD per gate as listed; aggregate: Parser→MIR→VM PoC end‑to‑end

Test Plan

  • Level 1 (Sanity): 4 tests → const/ret/binop/compare
  • Level 2 (Coverage): 10 tests → if/loops/arrays/strings/minimal recursion
  • Level 3 (PoC): 1 test → VM 5‑ops program runs (Pure Hakorune)
  • Policy: preconditions unmet → SKIP（WARN）; only regressions are FAIL

CI & Packaging (minimal)

  • CI minimal: cargo build --release + quick‑selfhost (SKIP前提で緑) + make release(manifest)
  • Windows builds: manual MSVC preferred; MinGW as reference
  • Dist: Linux + Windows(MSVC/MinGW) with README_FROZEN_QUICKSTART and release notes

Risks & Mitigations (short)

  • v1 != v2 drift → deterministic JSON + canonical emit + golden tests
  • Performance slow → accept PoC cost; profile hot paths; ≤30s budget for self‑compile later
  • Box不足 → pre‑surveyed minimal set; add only under gates

Next Steps (actionable)

  1. Lock Gate A/B test lists; add golden fixtures（json sorted）
  2. Implement VM PoC (5 ops) via HostBridge（apps/hakorune‑vm）
  3. Migrate op_eq with NoOperatorGuard + 20 golden tests
  4. Turn SKIP gates into PASS progressively（quick‑selfhost → plugins → integration）
  5. Update MILESTONE/INDEX weekly; keep artifacts/manifest fresh