56 lines
2.8 KiB
Markdown
56 lines
2.8 KiB
Markdown
Phase 15 — Self-Hosting (Cranelift AOT) 引き継ぎメモ
|
||
|
||
概要（2025-09-05）
|
||
- 目的: Nyash → MIR → Cranelift AOT → オブジェクト → リンク → EXE の最小パイプライン確立に向けた準備（設計/仕様/スモーク雛形）。
|
||
- 実装は別ブランチ `phase-15/self-host-aot-cranelift` で着手予定。現状はドキュメントと雛形スクリプトまで整備。
|
||
|
||
このブランチで完了したこと
|
||
- Cranelift AOT 設計とインタフェース草案のドキュメント追加:
|
||
- docs/backend-cranelift-aot-design.md
|
||
- docs/interfaces/cranelift-aot-box.md
|
||
- LinkerBox 仕様とAOTスモーク仕様（擬似出力）
|
||
- docs/interfaces/linker-box.md
|
||
- docs/tests/aot_smoke_cranelift.md
|
||
- Phase 15 集約README
|
||
- docs/phase-15/README.md
|
||
- スモーク雛形（DRYRUN既定。CLIF_SMOKE_RUN=1で実行）
|
||
- tools/aot_smoke_cranelift.sh（Unix/WSL）
|
||
- tools/aot_smoke_cranelift.ps1（Windows）
|
||
|
||
次にやること（別ブランチで実装）
|
||
1) ブランチ作成: `git switch -c phase-15/self-host-aot-cranelift`
|
||
2) CraneliftAotBox（PoC）
|
||
- `src/backend/cranelift/aot_box.rs` を追加
|
||
- `compile_stub_ny_main_i64(val, out_obj)` で `.o/.obj` を出力
|
||
- Cargo feature: `cranelift-aot = ["dep:cranelift-object"]`
|
||
3) LinkerBox（Windows優先）
|
||
- `.o/.obj` + NyRT（`libnyrt.a`/`nyrt.lib`）で EXE を生成
|
||
- 環境変数: `NYASH_LINKER`/`NYASH_LINK_FLAGS`/`NYASH_LINK_VERBOSE`
|
||
4) CLI 統合（PoC）
|
||
- `--backend cranelift-aot` と `--poc-const N`
|
||
5) スモーク
|
||
- apps/ny-hello → emit → link → run → `Result: 42` を確認
|
||
- 既存スクリプト雛形を “実行” モードで動くよう配線
|
||
|
||
運用メモ（Codex 非同期 2本）
|
||
- 2本起動: `CODEX_MAX_CONCURRENT=2 CODEX_DEDUP=1 ./tools/codex-keep-two.sh codex "<Task A>" "<Task B>"`
|
||
- 1本起動: `CODEX_ASYNC_DETACH=1 ./tools/codex-async-notify.sh "<task>" codex`
|
||
- ログ: `~/.codex-async-work/logs/`
|
||
|
||
スモーク雛形の使い方（DRYRUN）
|
||
- Unix/WSL: `./tools/aot_smoke_cranelift.sh release`
|
||
- Windows: `pwsh -File tools/aot_smoke_cranelift.ps1 -Mode release`
|
||
- 実行モード: `CLIF_SMOKE_RUN=1` を付与（AOT実装が入った後に使用）
|
||
|
||
参考リンク
|
||
- docs/phase-15/README.md（全体像）
|
||
- docs/backend-cranelift-aot-design.md（AOT設計）
|
||
- docs/interfaces/cranelift-aot-box.md（CraneliftAotBox API案）
|
||
- docs/interfaces/linker-box.md（LinkerBox仕様）
|
||
- docs/tests/aot_smoke_cranelift.md（スモーク仕様と擬似出力）
|
||
|
||
補足（メモリ/GC）
|
||
- P0/P1（定数返し/整数演算）では追加のメモリ系Boxは不要。
|
||
- P2以降で配列/文字列の生成・更新をAOTから行う場合、NyRTに最小のC ABI（roots/barrier/alloc系）を追加予定（docsに設計案を後続追記）。
|
||
|