55 lines
3.4 KiB
Markdown
55 lines
3.4 KiB
Markdown
# Phase 20.17 — Full Self‑Hosting (Freeze v1)
|
||
|
||
Goal
|
||
- Hakorune compiler is built by Hakorune itself (Stage‑N by Stage‑(N‑1)).
|
||
- Freeze v1 of language spec, MIR(JSON v0) schema, minimal stdlib/ABI.
|
||
- Rust remains a thin kernel (ABI/OS/HostHandle); no language semantics. 削減％は指標にしない。
|
||
- 開発作業の主戦場は `lang/` 配下（Nyash 側）。Rust は hako ABI で接続し、必要最小限の修正（不具合/境界整備）に限定。
|
||
|
||
Scope
|
||
- Selfhost line only (Fronts+Compiler+CoreVM). Rust line stays unchanged by default (gated).
|
||
- No feature expansion; only correctness, diagnostics stabilization, and fail‑fast.
|
||
- Runner は Core 直行（JSON→Interpreter）を既定にし、Ny ラッパー（NyVmDispatcher.run）は TTL の互換経路に留める。
|
||
|
||
Acceptance Criteria
|
||
- Selfhost build
|
||
- Stage 0 (Rust) builds Stage 1 (Hakorune compiler AOT/EXE)
|
||
- Stage 1 builds Stage 2 (same sources) with identical outputs (hash or canonical diff)
|
||
- Optionally Stage 2 builds Stage 3 for extra confidence (time‑boxed)
|
||
- Spec/ABI freeze
|
||
- MIR(JSON v0) fields and meaning are fixed and documented
|
||
- Core diagnostics use stable tags; smokes cover success/negative
|
||
- Exit semantics
|
||
- Numeric return maps to process exit code under Core route
|
||
- Non‑numeric return prints stable line; rc=0 only in Direct path
|
||
- Quick/integration profiles
|
||
- Gate off by default. With opt‑in gates, quick selfhost canaries are green; integration set is ≥95% pass.
|
||
|
||
Gates (default OFF)
|
||
- HAKO_SELFHOST=1 (alias NYASH_SELFHOST=1): enable selfhost route
|
||
- HAKO_GATE_C_CORE=1: force Gate‑C → Core VM direct
|
||
- HAKO_RUNNER_USE_SCRIPT_EXE=1: allow runner_front adopt to select selfhost route
|
||
|
||
Notes
|
||
- Strictness is at boundaries. Unknown keys in JSON/payload fail fast with stable tags.
|
||
- Rollback is gate removal; kernels stay intact.
|
||
- Strategy reference: `../FROZEN_TOOLCHAIN_STRATEGY.md`
|
||
- ABI 境界（hako ABI）は最小仕様（呼出規約/型/例外/戻り/所有）を安定化。変更は gate/TTL 配下で段階導入。
|
||
|
||
Progress (to date)
|
||
- Gate‑C(Core) numeric rc symmetry fixed（file/pipe、plugins on/off 代表OK）
|
||
- HKI（kni.*）正/負 canary が quick curated で緑（console/time/fs）
|
||
- Prelude STRICT（DeclOnly）を DFS/AST/unified の全経路に配線（決定的 Fail‑Fast）
|
||
- S2(strict) 既定ON。Emitter は ValueId 再番号・順序固定・単一パスで決定化済み
|
||
- Core mir_call: Array/Map の代表メソッド（size/push/pop/get/set/len）と負例タグが固定化
|
||
- Selfhost runner: nyvm(Core) 直行へ強制。Ny ラッパー経路の `Unknown module function: NyVmDispatcher.run/1` を回避。
|
||
- MIR(JSON v0) Reader: unary（unop）/params/Constructor/Const のネスト表現に対応。自己ホスト最小ケースで未定義レジスタの使用を解消。
|
||
- Selfhost 最小スモーク（emit→parse→execute）が PASS（quick, opt‑in）。
|
||
|
||
Next
|
||
- Self‑hosting の完了を最優先（S0→S1→S2 の確認強化、代表題材の拡充）
|
||
- 自己ホスト emit‑only 経路（child→親）の first‑line JSON 捕捉をスモークで固定。
|
||
- hakorune‑vm → CoreBridge の委譲収束（重複を削減、TTLコメント整備）
|
||
- HKI の負例タグ（代表ケース）の対称性チェックを docs/smokes に反映
|
||
- Optional/Bang（CallAttrs/Result統一）は 20.18 に延期（本フェーズは設計メモのみ）
|