feat: Phase 15.5 Week 1完了!llvmlite革命&環境変数完全整理
✅ llvmlite統一Call基盤革命達成 - mir_call.py: delegate→真の統一実装(6種Callee完全対応) - Global/Method/Constructor/Closure/Value/Extern統一処理 - 実際のLLVMハーネス動作確認(モックルート完全回避) ✅ 環境変数体系完全整理 - CLAUDE.md: モックルート回避設定完全文書化 - 複雑な環境変数組み合わせの成功パターン確立 ✅ Phase 15.5ドキュメント体系確立 - 実装状況追跡システム構築 - Week 1→2移行準備完了 🎯 Week 2開始準備: JSON出力統一→mir_json_emit.rs実装へ 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@ -0,0 +1,190 @@
|
||||
# JSON v0中心化戦略
|
||||
|
||||
**将来のRust離脱・多言語実装を見据えた基盤変革**
|
||||
|
||||
## 🎯 戦略概要
|
||||
|
||||
### 現状の問題
|
||||
```
|
||||
現在: AST → Rust MIR → 各実行器(バラバラ)
|
||||
問題: Rustに過度依存、実行器間でコード重複
|
||||
```
|
||||
|
||||
### 理想の未来
|
||||
```
|
||||
理想: すべて → JSON v0 → 実行器(統一)
|
||||
利点: 言語非依存、真実は1つ、デバッグ簡単
|
||||
```
|
||||
|
||||
### 現実的なアプローチ
|
||||
**段階的移行で既存機能を保護しながらJSON中心化**
|
||||
|
||||
## 📊 バージョン戦略
|
||||
|
||||
### 入出力の分離
|
||||
```
|
||||
json_in:v0 - Python parser → Rust(既存互換)
|
||||
json_out:v1 - Rust → 実行器(統一Call対応)
|
||||
```
|
||||
|
||||
### スキーマ進化
|
||||
```json
|
||||
{
|
||||
"ir_schema": "nyash-mir-json",
|
||||
"version": 1,
|
||||
"capabilities": [
|
||||
"unified_callee",
|
||||
"effect_mask",
|
||||
"call_flags"
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## 🔄 段階移行計画
|
||||
|
||||
### Phase A: JSON出力統一
|
||||
**目標**: 出力をJSON v1に統一
|
||||
```
|
||||
Rust MIR (内部正規形) → JSON v1 (交換形式) → 実行器
|
||||
```
|
||||
|
||||
**実装箇所**:
|
||||
- `mir_json_emit.rs`: 統一Call対応
|
||||
- スキーマバージョニング実装
|
||||
- 後方互換性維持
|
||||
|
||||
### Phase B: JSON中心化移行
|
||||
**目標**: MIRをJSON v0のラッパー化
|
||||
```
|
||||
AST → JSON v0 → MIR Module(薄ラッパー) → JSON v1
|
||||
```
|
||||
|
||||
**実装内容**:
|
||||
- JSON→MIRリーダーの薄化
|
||||
- HIR/名前解決情報のJSON化
|
||||
- 型安全ビューの実装
|
||||
|
||||
### Phase C: 完全JSON化
|
||||
**目標**: Rust MIR廃止準備
|
||||
```
|
||||
AST → JSON v0のみ(MIR Module廃止)
|
||||
```
|
||||
|
||||
**最終形**:
|
||||
- JSON v0が唯一の内部表現
|
||||
- Rustは高性能実行用の型安全ビューのみ
|
||||
- 多言語実装基盤完成
|
||||
|
||||
## 🏗️ アーキテクチャ設計
|
||||
|
||||
### 役割分担(Phase A-B)
|
||||
```
|
||||
Rust MIR: 内部正規形(最適化・検証・型安全)
|
||||
JSON: 境界/交換フォーマット(実行器・保存・デバッグ)
|
||||
```
|
||||
|
||||
### 最終形(Phase C)
|
||||
```
|
||||
JSON v0: 唯一の真実(保存・交換・デバッグ)
|
||||
型安全ビュー: 高性能処理用(Rust/他言語で実装)
|
||||
```
|
||||
|
||||
## 📋 統一CallのJSON化
|
||||
|
||||
### v1スキーマ例
|
||||
```json
|
||||
{
|
||||
"op": "call",
|
||||
"dst": 12,
|
||||
"callee": {
|
||||
"kind": "Method",
|
||||
"box_id": "StringBox",
|
||||
"method": "upper",
|
||||
"receiver": 7
|
||||
},
|
||||
"args": [42],
|
||||
"flags": ["tail_hint"],
|
||||
"effects": ["IO"]
|
||||
}
|
||||
```
|
||||
|
||||
### Calleeパターン
|
||||
```json
|
||||
// Global関数
|
||||
{"kind": "Global", "id": "nyash.builtin.print"}
|
||||
|
||||
// Method呼び出し
|
||||
{"kind": "Method", "box_id": "StringBox", "method": "len", "receiver": 3}
|
||||
|
||||
// Constructor
|
||||
{"kind": "Constructor", "box_type": "ArrayBox"}
|
||||
|
||||
// Extern関数
|
||||
{"kind": "Extern", "name": "nyash.console.log"}
|
||||
|
||||
// Value(動的)
|
||||
{"kind": "Value", "value_id": 5}
|
||||
|
||||
// Closure
|
||||
{"kind": "Closure", "params": ["x"], "captures": [{"name": "y", "id": 8}]}
|
||||
```
|
||||
|
||||
## ⚠️ リスク管理
|
||||
|
||||
### 回避すべき落とし穴
|
||||
|
||||
**1. 型喪失**
|
||||
- **問題**: 最適化・検証が弱くなる
|
||||
- **対策**: MIR型を先に保持し、JSONは運搬役に
|
||||
|
||||
**2. 性能劣化**
|
||||
- **問題**: 巨大関数のJSONパースがボトルネック
|
||||
- **対策**: バイナリ表現(FlatBuffers等)への移行余地確保
|
||||
|
||||
**3. 互換地獄**
|
||||
- **問題**: 一種類に固定すると後で詰む
|
||||
- **対策**: `json_in`/`json_out`分離で進化速度分離
|
||||
|
||||
### 撤退戦略
|
||||
各Phaseで前の状態に戻せる設計を維持
|
||||
|
||||
## 🧪 検証計画
|
||||
|
||||
### Phase A検証
|
||||
- [ ] 統一Call全パターンのJSON化
|
||||
- [ ] round-trip整合性(emit→read→emit)
|
||||
- [ ] 後方互換性(`NYASH_MIR_UNIFIED_CALL=0`でv0出力)
|
||||
- [ ] PyVM実行(`print(2)`等の最小ケース)
|
||||
|
||||
### Phase B検証
|
||||
- [ ] JSON→MIRラッパーの型安全性
|
||||
- [ ] HIR情報の完全保持
|
||||
- [ ] パフォーマンス劣化なし
|
||||
|
||||
### Phase C検証
|
||||
- [ ] 他言語実装の技術実証
|
||||
- [ ] Rust MIR廃止の影響範囲確認
|
||||
- [ ] セルフホスティング準備完了
|
||||
|
||||
## 🔗 関連技術
|
||||
|
||||
### フォーマット候補
|
||||
- **JSON**: 人間可読、デバッグ簡単(Phase A-B)
|
||||
- **MessagePack**: バイナリ効率化(Phase C候補)
|
||||
- **FlatBuffers**: ゼロコピー高速化(将来候補)
|
||||
|
||||
### 互換性管理
|
||||
```json
|
||||
{
|
||||
"format": "json-v1",
|
||||
"compression": "none",
|
||||
"extensions": ["unified_call", "effect_tracking"]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**ChatGPT戦略の核心**:
|
||||
> "急がず・壊さず・段階的に" JSON v0を中心とした基盤に移行
|
||||
|
||||
これにより、セルフホスティング成功と将来の多言語実装基盤が両立する。
|
||||
Reference in New Issue
Block a user