81 lines
4.4 KiB
Markdown
81 lines
4.4 KiB
Markdown
# 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
|