44 lines
2.5 KiB
Markdown
44 lines
2.5 KiB
Markdown
# Phase 20.10 — Script‑First Runner (C‑ABI Unified)
|
||
|
||
Status
|
||
- In progress（部分的に完了）。Runner facade は既定ON（opt‑outで静穏運用可）。
|
||
|
||
Intent
|
||
- Move policy/coordination logic closer to Hakorune (script) while keeping data‑plane at the C‑ABI boundary.
|
||
- Unify extern calls via C‑ABI (`hako_*`) and minimize Rust‑only decision points.
|
||
- Preserve VM/LLVM parity and provide small, reversible steps (Fail‑Fast / Box‑First).
|
||
|
||
Scope (this phase)
|
||
- Python/llvmlite 降ろしは据え置き（変更対象外）。
|
||
- 対象: 実行エンジンとランナー（調停/方針部分）・Extern/効果解決・CLI/ENV/設定の「上物」を Hakorune スクリプト側に寄せる。
|
||
- ルール: Extern は C‑ABI (`hako_*`) 経由に統一し、dotted C シンボルは AOT に流さない。
|
||
|
||
High‑Level Goals
|
||
- Script Runner（Ref‑VM/Runner facade）を lang 側に置き、エントリ/コーディネーションを段階移譲。
|
||
- Extern/Effects の解決方針を SSOT で管理（将来 TOML → Rust/Python 生成）。
|
||
- CLI/ENV は CLI を正、ENV は補助（HAKO_* を第一表記）に統一。
|
||
|
||
Outcomes so far（20.10 前半の成果）
|
||
- Runner pre‑invoke（既定ON）
|
||
- 成功/失敗の短文を固定（stdout）：`[script-runner] invoke` / `invoke: FAIL`。
|
||
- 代表スモーク（quick/integration-core）を追加（invoke / workspace-only）。
|
||
- UsingResolver の前段/比較/シャドウの観測フックを追加（挙動不変）。
|
||
- Externs SSOT
|
||
- `specs/externs.toml` を SSOT とし、生成スクリプトで Python/Rust を同期。
|
||
- チェックを STRICT へ昇格（drift は FAIL）。
|
||
- Effects の取り込み導線（env）：`HAKO_EXTERN_EFFECTS_SSOT=1`（Io を反映）。
|
||
- AOT selfhost ランチャ（最小）
|
||
- `lang/build/build_runner.sh` で `lang/bin/hakorune` を生成（LLVM18 dev が必要）。
|
||
- 代表スモーク（quick）でビルド→実行を確認（exit code=0）。
|
||
|
||
Out‑of‑Scope
|
||
- Python/llvmlite の大きな構造変更（降ろしは現状維持）。
|
||
- GC/IO/例外/非同期の実装拡張（本フェーズでは扱わない）。
|
||
|
||
Risk & Rollback
|
||
- すべて gate 配下（既定 OFF）。スモークは parity/diagnostics のみを増強。
|
||
- 戻し手順: gate を OFF、または Runner 経路を既存 Rust ラインへ戻すだけで可逆。
|
||
|
||
TTL（bring‑up 限定トグル）
|
||
- `HAKO_SCRIPT_RUNNER_FORCE_FAIL`, `HAKO_SCRIPT_RUNNER_TRACE` は撤退済み。固定短文のみ維持（invoke/FAIL）。
|