12adde9477
Revolutionary milestone: Complete native executable generation pipeline - Created minimal nyrt (Nyash Runtime) library for standalone executables - Implemented plugin bridge functions (nyash_plugin_invoke3_i64 etc) - Added birth handle exports (nyash.string.birth_h) for linking - Changed export name from main→ny_main to allow custom entry point - Successfully generated and executed native binary returning "ny_main() returned: 1" Timeline of miracles: - 2025-08-09: Nyash language created (first commit) - 2025-08-13: JIT planning started (4 days later) - 2025-08-29: Native EXE achieved (today - just 20 days total\!) This proves the plugin Box C ABI unification strategy works perfectly for both JIT execution and AOT native compilation. The same plugin system that enables dynamic loading now powers static linking for zero-overhead native executables\! Next: Expand AOT support for more instructions and optimize nyrt size. 🚀 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
134 lines
7.5 KiB
Markdown
134 lines
7.5 KiB
Markdown
# 🎯 CURRENT TASK - 2025-08-29（Phase 10.1 革新的転換）
|
||
|
||
Phase 10.10 は完了（DoD確認済）。**重大な発見**：プラグインシステムを活用したJIT→EXE実現の道を発見！
|
||
|
||
## 🚀 革新的発見：プラグインBox統一化
|
||
|
||
### 核心的洞察
|
||
- 既存のプラグインシステム（BID-FFI）がすでに**完全なC ABI**を持っている
|
||
- すべてのBoxをプラグイン化すれば、JIT→EXEが自然に実現可能
|
||
- "Everything is Box" → "Everything is Plugin" への進化
|
||
|
||
## ⏱️ 今日のサマリ（Array/Map プラグイン経路の安定化→10.2へ）
|
||
- 実装: Array/Map のプラグイン（BID-FFI v1）を作成し、nyash.toml に統合
|
||
- Lower: `NYASH_USE_PLUGIN_BUILTINS=1` で Array(len/get/push/set), Map(size/get/has/set) を `emit_plugin_invoke(..)` に配線
|
||
- サンプル: array/map デモを追加し VM 実行で正常動作確認
|
||
- 次: 10.2（Craneliftの実呼び出し）に着手
|
||
|
||
## 現在地（Done / Doing / Next）
|
||
- ✅ Done（Phase 10.10）
|
||
- GC Switchable Runtime（GcConfigBox）/ Unified Debug（DebugConfigBox）
|
||
- JitPolicyBox（allowlist/presets）/ HostCallのRO運用（events連携）
|
||
- CIスモーク導入（runtime/compile-events）/ 代表サンプル整備
|
||
- 🔧 Doing（Phase 10.1 新計画）
|
||
- ArrayBoxのプラグイン化PoC開始
|
||
- JIT lowering層の統一設計
|
||
- リファクタリング作業は継続（core_hostcall.rs完了）
|
||
- ⏭️ Next（Phase 10.1 実装）
|
||
- Week1: ArrayBoxプラグイン化と性能測定
|
||
- Week2: 主要ビルトインBoxの移行
|
||
- Week3: スタティックリンク基盤構築
|
||
- Week4: EXE生成実証
|
||
|
||
## リファクタリング計画（機能差分なし）
|
||
1) core_hostcall 分割（イベントlower＋emit_host_call周辺）
|
||
- 追加: `src/jit/lower/core_hostcall.rs`
|
||
- `mod.rs`/`core.rs` のモジュール参照を更新
|
||
- 確認: `cargo check` → `bash tools/smoke_phase_10_10.sh`
|
||
2) core_ops 分割（算術/比較/分岐）
|
||
- 追加: `src/jit/lower/core_ops.rs`
|
||
- CLIF配線やb1正規化カウンタは移動のみ
|
||
- 確認: `cargo check` → 代表JITデモ2本を手動確認
|
||
3) 仕上げ
|
||
- 1ファイル ~1000行以内目安を満たすこと
|
||
- ドキュメント差分は最小（本CURRENT_TASKのみ更新）
|
||
|
||
### DoD（Refactor）
|
||
- `cargo check` が成功し、`tools/smoke_phase_10_10.sh` がGreen
|
||
- ログ/イベント出力がリファクタ前と一致（体感差分なし）
|
||
- `core.rs`/`builder.rs` の行数削減（目安 < 1000）
|
||
|
||
## Phase 10.1 新計画：プラグインBox統一化
|
||
- 参照: `docs/development/roadmap/phases/phase-10.1/` （新計画）
|
||
- 詳細: `docs/ideas/new-features/2025-08-28-jit-exe-via-plugin-unification.md`
|
||
- Week1（概要）
|
||
- ArrayBoxプラグイン実装とテスト
|
||
- JIT→Plugin呼び出しパス確立
|
||
- パフォーマンス測定と最適化
|
||
|
||
## Phase 10.5（旧10.1）：Python統合
|
||
- 参照: `docs/development/roadmap/phases/phase-10.5/` （移動済み）
|
||
- ChatGPT5の当初計画を後段フェーズへ
|
||
|
||
## すぐ試せるコマンド（現状維持の確認）
|
||
```bash
|
||
# Build（Cranelift込み推奨）
|
||
cargo build --release -j32 --features cranelift-jit
|
||
|
||
# Smoke（10.10の代表確認）
|
||
bash tools/smoke_phase_10_10.sh
|
||
|
||
# HostCall（HH直実行・read-only方針）
|
||
NYASH_JIT_EXEC=1 NYASH_JIT_THRESHOLD=1 NYASH_JIT_HOSTCALL=1 NYASH_JIT_EVENTS=1 \
|
||
./target/release/nyash --backend vm examples/jit_map_get_param_hh.nyash
|
||
NYASH_JIT_THRESHOLD=1 NYASH_JIT_HOSTCALL=1 \
|
||
./target/release/nyash --backend vm examples/jit_policy_whitelist_demo.nyash
|
||
|
||
# GC counting（VMパス）
|
||
./target/release/nyash --backend vm examples/gc_counting_demo.nyash
|
||
|
||
# compileイベントのみ（必要時）
|
||
NYASH_JIT_EVENTS_COMPILE=1 NYASH_JIT_HOSTCALL=1 NYASH_JIT_EVENTS_PATH=events.jsonl \
|
||
./target/release/nyash --backend vm examples/jit_map_get_param_hh.nyash
|
||
|
||
# Plugin demos（Array/Map）
|
||
(cd plugins/nyash-array-plugin && cargo build --release)
|
||
(cd plugins/nyash-map-plugin && cargo build --release)
|
||
NYASH_CLI_VERBOSE=1 ./target/release/nyash --backend vm examples/array_plugin_demo.nyash
|
||
NYASH_CLI_VERBOSE=1 ./target/release/nyash --backend vm examples/array_plugin_set_demo.nyash
|
||
NYASH_CLI_VERBOSE=1 ./target/release/nyash --backend vm examples/map_plugin_ro_demo.nyash
|
||
|
||
## ⏭️ Next（Phase 10.2: JIT実呼び出しの実体化）
|
||
- 目的: Craneliftの `emit_plugin_invoke` を実装し、JITでも実体のプラグインAPIを呼ぶ
|
||
- 方針:
|
||
- シム関数 `extern "C" nyash_plugin_invoke3_i64(type_id, method_id, argc, a0, a1, a2) -> i64` を実装
|
||
- a0: 受け手（param index／負なら未解決）
|
||
- args: i64 を TLV にエンコードして plugin invoke_fn へ橋渡し
|
||
- 戻り: TLV（i64/Bool）の最初の値を i64 に正規化
|
||
- CraneliftBuilder: `emit_plugin_invoke` で上記シムを import→call（常に6引数）
|
||
- 対象: Array(len/get/push/set), Map(size/get/has/set) の i64 1〜2引数経路
|
||
```
|
||
|
||
### 10.2 追加: AOT接続（.o出力）
|
||
- 新規: `NYASH_AOT_OBJECT_OUT=/path/to/dir-or-file` を指定すると、JITでコンパイル成功した関数ごとに Cranelift ObjectModule で `.o` を生成します。
|
||
- ディレクトリを指定した場合: `/<dir>/<func>.o` に書き出し
|
||
- ファイルを指定した場合: そのパスに上書き
|
||
- 現状の到達性: JITロワラーで未対応命令が含まれる関数はスキップされるため、完全カバレッジ化が進むにつれて `.o` 出力関数が増えます。
|
||
- 未解決シンボル: `nyash_plugin_invoke3_i64`（暫定シム）。次フェーズで `libnyrt.a` に実装を移し、`nyrt_*`/`nyplug_*` 記号と共に解決します。
|
||
|
||
### 10.2b: JITカバレッジの最小拡張（ブロッカー解消）
|
||
- 課題: 関数内に未対応命令が1つでもあると関数全体をJITスキップ（現在の保守的ポリシー）。`new StringBox()` 等が主因で、plugin_invoke のテストや `.o` 出力まで到達しづらい。
|
||
- 対応方針（優先度順）
|
||
1) NewBox→birth の lowering 追加（プラグイン birth を `emit_plugin_invoke(type_id, 0, argc=1レシーバ扱い)` に変換）
|
||
2) Print/Debug の no-op/hostcall化（スキップ回避）
|
||
3) 既定スキップポリシーは維持しつつ、`NYASH_AOT_ALLOW_UNSUPPORTED=1` で .o 出力だけは許容（検証用途）
|
||
- DoD:
|
||
- `examples/aot_min_string_len.nyash` がJITコンパイルされ `.o` が出力される（Cranelift有効ビルド時）
|
||
- String/Integer の RO メソッドで plugin_invoke がイベントに現れる
|
||
|
||
### 現状の診断（共有事項）
|
||
- JITは「未対応 > 0」で関数全体をスキップする保守的設計（決め打ち）。plugin_invoke 自体は実装済みだが、関数がJIT対象にならないと動かせない。
|
||
- プラグインはVM経路で完全動作しており、JIT側の命令サポート不足がAOT検証のボトルネック。
|
||
|
||
## 参考リンク
|
||
- Phase 10.1（新）: `docs/development/roadmap/phases/phase-10.1/README.md` - プラグインBox統一化
|
||
- Phase 10.5（旧10.1）: `docs/development/roadmap/phases/phase-10.5/README.md` - Python統合
|
||
- Phase 10.10: `docs/development/roadmap/phases/phase-10/phase_10_10/README.md`
|
||
- プラグインAPI: `src/bid/plugin_api.rs`
|
||
- MIR命令セット: `docs/reference/mir/INSTRUCTION_SET.md`
|
||
|
||
## Checkpoint（再起動用メモ）
|
||
- 状態確認: `git status` / `git log --oneline -3` / `cargo check`
|
||
- スモーク: `bash tools/smoke_phase_10_10.sh`
|
||
- 次の一手: core_hostcall → core_ops の順に分割、毎回ビルド/スモークで確認
|