a60d840b47
Phase 15 requires concentrated development on PyVM and LLVM backends only. JIT/Cranelift was causing build confusion and distracting AI developers. ## Archived Components - src/jit/ → archive/jit-cranelift/src/jit/ - src/backend/cranelift/ → archive/jit-cranelift/src/backend/cranelift/ - JIT Box modules → archive/jit-cranelift/src/boxes/ - JIT scripts → archive/jit-cranelift/scripts/, tools/ - clif_adapter.rs → archive/jit-cranelift/src/semantics/ ## Build Changes - Cargo.toml: Comment out cranelift-jit feature and dependencies - src/lib.rs: Disable JIT module declaration - src/boxes/mod.rs: Disable JIT Box module declarations - src/semantics/mod.rs: Disable clif_adapter module - debug_box.rs: Replace JIT calls with archive stubs ## Documentation - archive/jit-cranelift/ARCHIVE_NOTES.md: Complete restoration guide - Reason: Phase 15 selfhosting focus (80k→20k line reduction) - Restoration: Full procedure documented for future revival This eliminates build errors and AI developer confusion, enabling focused Phase 15 development on PyVM/LLVM backends only. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
96 lines
3.1 KiB
Markdown
96 lines
3.1 KiB
Markdown
# JIT/Cranelift アーカイブ - Phase 15
|
||
|
||
## 📅 アーカイブ日時
|
||
2025-09-23 - Phase 15 セルフホスティング集中開発期間中
|
||
|
||
## 🎯 アーカイブ理由
|
||
|
||
### 現在の開発焦点
|
||
- **Phase 15**: Nyashセルフホスティング（80k→20k行革命）
|
||
- **開発対象**: PyVMとLLVMバックエンドのみ
|
||
- **JIT/Cranelift**: 現在未使用、ビルドエラーや混乱の原因
|
||
|
||
### 具体的な問題
|
||
1. **ビルドエラー**: `cranelift-jit` フィーチャーでのビルド失敗
|
||
2. **AI開発者の混乱**: JSON開発Claude Codeが誤ってJITルートを参照
|
||
3. **リソース分散**: メンテナンスコストが高い
|
||
4. **Phase 15集中**: PyVM/LLVM開発に集中したい
|
||
|
||
## 📂 アーカイブ内容
|
||
|
||
### 移動されたディレクトリ・ファイル
|
||
```
|
||
archive/jit-cranelift/
|
||
├── src/
|
||
│ ├── jit/ # JIT実装コア（ABI、エンジン、ローワリング等）
|
||
│ └── backend/cranelift/ # Craneliftバックエンド実装
|
||
├── scripts/
|
||
│ └── build_jit.sh # JITビルドスクリプト
|
||
└── tools/
|
||
├── jit_compare_smoke.sh # JIT比較スモークテスト
|
||
└── smokes/
|
||
├── jit_smoke.sh # JITスモークテスト
|
||
└── smoke_vm_jit.sh # VM-JIT比較テスト
|
||
```
|
||
|
||
### Cargo.toml変更
|
||
- `cranelift-jit` フィーチャーをコメントアウト
|
||
- JIT関連の依存関係を無効化
|
||
|
||
## 🔄 復活手順（将来用）
|
||
|
||
### 1. ファイル復元
|
||
```bash
|
||
# アーカイブから復元
|
||
mv archive/jit-cranelift/src/jit src/
|
||
mv archive/jit-cranelift/src/backend/cranelift src/backend/
|
||
mv archive/jit-cranelift/scripts/build_jit.sh .
|
||
mv archive/jit-cranelift/tools/* tools/
|
||
```
|
||
|
||
### 2. Cargo.toml復元
|
||
```toml
|
||
[features]
|
||
cranelift-jit = ["dep:cranelift", "dep:cranelift-jit", "dep:cranelift-module"]
|
||
|
||
[dependencies]
|
||
cranelift = { version = "0.103", optional = true }
|
||
cranelift-jit = { version = "0.103", optional = true }
|
||
cranelift-module = { version = "0.103", optional = true }
|
||
```
|
||
|
||
### 3. ビルド確認
|
||
```bash
|
||
# JITビルドテスト
|
||
cargo build --release --features cranelift-jit
|
||
|
||
# スモークテスト実行
|
||
./tools/jit_smoke.sh
|
||
```
|
||
|
||
### 4. 統合テスト
|
||
- PyVM vs JIT性能比較
|
||
- LLVM vs JIT出力比較
|
||
- 全バックエンド統合テスト
|
||
|
||
## 💡 設計ノート
|
||
|
||
### JIT実装の特徴
|
||
- **Cranelift統合**: Wasmtime/Craneliftエコシステム活用
|
||
- **ホストコール最適化**: Rustネイティブ関数との高速ブリッジ
|
||
- **メモリ管理**: GCとJITの協調動作
|
||
- **デバッグ支援**: JIT統計・トレース機能
|
||
|
||
### 将来的な価値
|
||
- **高速実行**: 本格運用時の性能向上
|
||
- **AOTコンパイル**: ネイティブバイナリ生成
|
||
- **WebAssembly統合**: WASM実行環境との統一
|
||
|
||
## 📋 関連Issue・PR
|
||
- JIT/Craneliftビルドエラー修正が必要
|
||
- AIエージェント向けドキュメント整備
|
||
- Phase 15完了後の復活検討
|
||
|
||
---
|
||
|
||
**Note**: このアーカイブは一時的な措置です。Phase 15完了後、JIT/Craneliftの復活と最新化を検討します。 |