128 lines
3.2 KiB
Markdown
128 lines
3.2 KiB
Markdown
|
# 段階的実装の階段プラン - 壊れない設計
|
|||
|
|
|
|||
|
|
作成日: 2025-08-27
|
|||
|
|
Status: 実装指針
|
|||
|
|
Priority: High
|
|||
|
|
Related: ChatGPT5との共同構想
|
|||
|
|
|
|||
|
|
## 🎯 設計哲学
|
|||
|
|
|
|||
|
|
**段階で積める設計＝強い**し、破綻しにくい
|
|||
|
|
|
|||
|
|
各段階で必ず「合格証（ゲート）」を取ってから次へ進む。いつでも戻せる安全網付き。
|
|||
|
|
|
|||
|
|
## 🏗️ 階段プラン（壊さない順）
|
|||
|
|
|
|||
|
|
### 1. 凍結する契約（小さく）
|
|||
|
|
```
|
|||
|
|
固定する最小限の仕様：
|
|||
|
|
- MIR1の命令表＋効果（pure/read/write/io/atomic）
|
|||
|
|
- 強1本・weak非伝播・@must_drop/@gcableの検証規則
|
|||
|
|
- VM-BC（3アドレス）の呼出規約
|
|||
|
|
|
|||
|
|
→ 1枚のmdに固定（後は後方互換で拡張）
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. 段階ゲート（各段の合格条件）
|
|||
|
|
|
|||
|
|
#### VM段階
|
|||
|
|
- `interp==vm`（出力/I/Oログ一致）
|
|||
|
|
- `bytes_copied==0`（指定区間）
|
|||
|
|
|
|||
|
|
#### Cranelift v0段階
|
|||
|
|
- `interp==vm==jit`一致
|
|||
|
|
- CLIF verifier pass
|
|||
|
|
|
|||
|
|
#### GC(epoch)段階
|
|||
|
|
- `--gc=on/off`でI/Oログ差分0
|
|||
|
|
- @must_dropのみ監視
|
|||
|
|
|
|||
|
|
#### SyncBox v0段階
|
|||
|
|
- `table.put()`で自動ロック
|
|||
|
|
- `read/with`で借用
|
|||
|
|
- Lintが違反を落とす
|
|||
|
|
|
|||
|
|
### 3. 最適化は「中立」をMIR1に集約
|
|||
|
|
|
|||
|
|
どのバックエンドにも効く系だけ先に：
|
|||
|
|
- canonicalize / CSE / copy-prop / dead-branch（pure域）
|
|||
|
|
- bus-elision（安全条件下）
|
|||
|
|
- weak_load fast-path
|
|||
|
|
|
|||
|
|
### 4. 将来の二段化（MIR2）の入口だけ作る
|
|||
|
|
```
|
|||
|
|
準備だけ先行：
|
|||
|
|
- MIR1→MIR2 loweringスケルトン（例外なし・Box展開だけ）
|
|||
|
|
- MIR2のVerifier（LOCKペア/アライン）だけ先に用意
|
|||
|
|
→ 当面はCraneliftだけMIR2から食わせる
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 5. キルスイッチ/保険
|
|||
|
|
```bash
|
|||
|
|
# 怪しい時に戻せるスイッチを常備
|
|||
|
|
--no-elide-bus # Bus最適化無効
|
|||
|
|
--jit=off # JIT無効化
|
|||
|
|
--gc=off|epoch # GC切替
|
|||
|
|
--sync=warn-only # 同期チェックのみ
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 6. CIの黄金テスト（毎回回す）
|
|||
|
|
|
|||
|
|
#### 互換性
|
|||
|
|
```
|
|||
|
|
interp == vm == jit
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 資源管理
|
|||
|
|
```
|
|||
|
|
open == fini(@must_drop)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 性能指標
|
|||
|
|
```
|
|||
|
|
- ゼロコピー: dup()以外で bytes_copied==0
|
|||
|
|
- 退行防止: send_count/alloc_count が基準以下
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 7. メトリクスの見取り図
|
|||
|
|
```
|
|||
|
|
収集データ：
|
|||
|
|
- op_count/hot_bb（VMプロファイル→MIR属性に反映）
|
|||
|
|
- alloc/free・bytes_copied・send/recv
|
|||
|
|
- p95/p99レイテンシ（finiスパイク検知）
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 8. 小さなデモを常に1本
|
|||
|
|
```
|
|||
|
|
http_static_zero_copy
|
|||
|
|
- 機能：HTTPサーバーでゼロコピー配信
|
|||
|
|
- ゼロコピー：bytes_copied==0の確認
|
|||
|
|
- GC等価：--gc=on/offで挙動一致
|
|||
|
|
|
|||
|
|
→ これが通れば次の段へ進む合図
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 💡 実装の心得
|
|||
|
|
|
|||
|
|
### 複雑さは増えても破綻しない理由
|
|||
|
|
1. **凍結する契約**を小さく決める
|
|||
|
|
2. **各段で合格証**を取る
|
|||
|
|
3. **キルスイッチ**でいつでも戻せる
|
|||
|
|
4. **黄金テスト**で退行を防ぐ
|
|||
|
|
|
|||
|
|
### 最適化の原則
|
|||
|
|
- MIRに集約すれば全ルートに効く
|
|||
|
|
- バックエンド固有は避ける
|
|||
|
|
- 中立最適化を優先
|
|||
|
|
|
|||
|
|
## ✅ 直近の実装順序
|
|||
|
|
|
|||
|
|
1. **今日**: VM基盤の安定化
|
|||
|
|
2. **明日**: Cranelift最小実装
|
|||
|
|
3. **今週**: GC epochフック
|
|||
|
|
4. **来週**: SyncBox MVP
|
|||
|
|
5. **継続**: 黄金テストの拡充
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
*「壊れない設計」- 段階で積めば、複雑さは増えても破綻しない*
|