hakorune/docs/handoff/phase-15-handoff.md

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に設計案を後続追記）。