401 lines
12 KiB
Markdown
401 lines
12 KiB
Markdown
# Phase 15.75 — 完全脱Rust大作戦 📚 エントリーポイント
|
||
|
||
**最終更新**: 2025-10-14
|
||
**ステータス**: 計画段階 → 実装開始準備中
|
||
**目的**: Rust 99,406行 → 10,400行（89.5%削減）への完全ロードマップ
|
||
|
||
---
|
||
|
||
## ⚡ **超急ぎの人向け（3分で全部わかる）**
|
||
|
||
### 🎯 **Phase 15.75を1行で説明**
|
||
|
||
```
|
||
Rust 99,406行 → 10,400行（89.5%削減）を1ヶ月で実現
|
||
MIR疎結合により失敗時Rollback可能なゼロリスク計画
|
||
```
|
||
|
||
### 🚀 **今すぐやる3ステップ**
|
||
|
||
#### **ステップ1: スモークテスト確認（2分）**
|
||
```bash
|
||
bash tools/smokes/v2/run.sh --profile quick-selfhost
|
||
# 期待: 170/185 PASS（現状維持）
|
||
```
|
||
|
||
#### **ステップ2: TODO読む（5分）**
|
||
```bash
|
||
cat "docs/private/roadmap/phases/phase-15.75/TODO.md"
|
||
|
||
# 確認内容:
|
||
# - Phase 1（MirCall）準備タスク
|
||
# - plugin-on スモーク拡充
|
||
# - HostHandleRouter 段階移設
|
||
```
|
||
|
||
#### **ステップ3: 1つ選んで実装開始**
|
||
```bash
|
||
# Option A: 安全メソッドの whitelist を箱化
|
||
# - normalize.rs に is_safe_core_method 追加
|
||
|
||
# Option B: Callable(argv 再構成) のパリティ確認
|
||
# - arity>0 の methodRef.call(argv) 正常系スモーク追加
|
||
|
||
# Option C: HostHandleRouter 境界スモーク
|
||
# - 型不一致を明示検出するスモーク追加
|
||
```
|
||
|
||
### 🚨 **失敗したらどうなる？**
|
||
|
||
```
|
||
✅ いつでもRollbackできます！
|
||
|
||
Level 1: バックエンド切替（0秒）
|
||
./hakorune-stage0.exe problem.hako
|
||
|
||
Level 2: Parser Rollback（5-10分）
|
||
vim selfhost/compiler/parser.hako → 修正
|
||
|
||
Level 3: Full Rollback（10-30分）
|
||
git checkout stage0-preserved
|
||
```
|
||
|
||
詳細: [STRATEGY.md](./STRATEGY.md)
|
||
|
||
---
|
||
|
||
## 🚀 **今すぐ読むべきドキュメント（優先順）**
|
||
|
||
### 1️⃣ **[TODO.md](./TODO.md)** ← 👈 **ここから始める！**
|
||
**読むべき人**: 今すぐ作業開始したい人
|
||
**内容**: 次の1-2週間でやるべきこと（P1スコープ）
|
||
**所要時間**: 5分
|
||
|
||
```
|
||
✅ 完了済み: Map.call P1, Fallback箱化, HostHandleRouter stub
|
||
📋 次のアクション:
|
||
- Phase 1（MirCall）小粒・箱化方針で進行
|
||
- plugin-on スモーク拡充
|
||
- HostHandleRouter 段階移設
|
||
```
|
||
|
||
**結論**: 具体的な作業リストが欲しい → TODO.md
|
||
|
||
---
|
||
|
||
### 2️⃣ **[ROADMAP.md](./ROADMAP.md)** ← 全体像を知りたい人
|
||
**読むべき人**: 「なぜRust削減するのか」「どうやって実現するのか」を知りたい人
|
||
**内容**: Phase 15.75の全体戦略と詳細タスクリスト
|
||
**所要時間**: 15-20分
|
||
|
||
```
|
||
📊 削減計画:
|
||
- Option A: 99,406行 → 10,400行（89.5%削減）
|
||
- Phase 1-5: 淡々とタスクを消化
|
||
|
||
🎯 核心戦略:
|
||
- Rust VM → Hakorune VM（自己実装）
|
||
- Parser → Selfhost Parser（.hako実装）
|
||
- Boxes → Plugins（プラグインシステム）
|
||
```
|
||
|
||
**結論**: 全体像と背景理論を理解したい → ROADMAP.md
|
||
|
||
---
|
||
|
||
### 2.5️⃣ **Stage‑4（最短導線）**
|
||
**ChatGPT最小プラン（2日）**: [stage-4-chatgpt/INDEX.md](./stage-4-chatgpt/INDEX.md)
|
||
- 2関数のC ABIハーネス / feature配下 / スモーク1本（bothヘッダ一致）
|
||
- 先の統合戦略: [INTEGRATION_STRATEGY_CLAUDE.md](./stage-4-chatgpt/INTEGRATION_STRATEGY_CLAUDE.md)
|
||
|
||
**フル設計（Claude版）**: [stage-4/INDEX.md](./stage-4/INDEX.md)
|
||
|
||
---
|
||
|
||
### 2.6️⃣ **Next Phase（15.76）**
|
||
**extern_c / Self‑Host Bootstrap**: ../phase\ 15.76/INDEX.md
|
||
- TODO: ../phase\ 15.76/TODO.md
|
||
|
||
---
|
||
|
||
### 3️⃣ **[STRATEGY.md](./STRATEGY.md)** ← 失敗が怖い人
|
||
**読むべき人**: 「本当に安全なのか」「失敗したらどうなるのか」が不安な人
|
||
**内容**: MIR疎結合によるゼロリスク戦略 + ツールチェーン要件
|
||
**所要時間**: 15分
|
||
|
||
```
|
||
🔄 Rollbackレベル:
|
||
- Level 1: バックエンド切替（0秒）
|
||
- Level 2: Parser Rollback（5-10分）
|
||
- Level 3: Full Rollback（10-30分）
|
||
|
||
✅ 核心原則:
|
||
- Stage 0/1/2並行運用（いつでも戻れる）
|
||
- MIR = 疎結合ポイント（バックエンド交換可能）
|
||
|
||
🔧 ツールチェーン:
|
||
- HakoBuildBox（500-800行）
|
||
- HakoLspBox（1,200-2,000行）
|
||
```
|
||
|
||
**結論**: リスク管理とツールチェーンを知りたい → STRATEGY.md
|
||
|
||
---
|
||
|
||
### 4️⃣ **[ANALYSIS.md](./ANALYSIS.md)** ← 「1ヶ月で可能？」と思った人
|
||
**読むべき人**: 実績ベースの見積もり根拠を知りたい人
|
||
**内容**: Git履歴に基づく速度分析 + 3者見積もり比較
|
||
**所要時間**: 10分
|
||
|
||
```
|
||
📊 実績データ:
|
||
- 21.6コミット/日（66日間）
|
||
- 115行/日削減（直近13日間）
|
||
- M2/M3達成: 63日（業界標準の29倍速）
|
||
|
||
🎯 結論:
|
||
- ユーザー「1ヶ月」✅ 正しい（Phase 1-2コア完了）
|
||
- Gemini「1年以上」❌ 業界標準ベース
|
||
- Claude「6ヶ月」❌ 実績を無視した理論値
|
||
```
|
||
|
||
**結論**: 1ヶ月の根拠を知りたい → ANALYSIS.md
|
||
|
||
---
|
||
|
||
## 🎯 **あなたの状況別ガイド**
|
||
|
||
### 🚀 **「今すぐ作業したい」**
|
||
```
|
||
1. TODO.md 読む（5分）
|
||
2. 作業開始！
|
||
```
|
||
|
||
### 📚 **「全体を理解してから作業したい」**
|
||
```
|
||
1. ROADMAP.md 読む（15分）
|
||
→ 全体像理解
|
||
2. STRATEGY.md 読む（15分）
|
||
→ 安全性確認
|
||
3. TODO.md 読む（5分）
|
||
→ 作業開始
|
||
```
|
||
|
||
### 🔍 **「リスクが心配」**
|
||
```
|
||
1. STRATEGY.md 読む（15分）
|
||
→ Rollback手順確認
|
||
2. TODO.md 読む（5分）
|
||
→ 段階的作業開始
|
||
```
|
||
|
||
### 📊 **「1ヶ月で本当に可能？」**
|
||
```
|
||
1. ANALYSIS.md 読む（10分）
|
||
→ 実績ベースの根拠確認
|
||
2. ROADMAP.md 読む（15分）
|
||
→ 詳細計画確認
|
||
```
|
||
|
||
---
|
||
|
||
## 📊 **4つのドキュメントの関係図**
|
||
|
||
```
|
||
┌─────────────────────────────────────────┐
|
||
│ ROADMAP.md │
|
||
│ （全体戦略 + Phase別タスクリスト） │
|
||
│ - なぜRust削減するのか │
|
||
│ - Phase 1-5 詳細スケジュール │
|
||
│ - 週次TODO展開 │
|
||
└────────────┬────────────────────────────┘
|
||
│
|
||
┌────────┴────────┐
|
||
│ │
|
||
┌───▼──────────┐ ┌──▼─────────────────────┐
|
||
│ STRATEGY.md │ │ ANALYSIS.md │
|
||
│ （戦略・安全）│ │ （実績分析） │
|
||
│ - Rollback │ │ - Git履歴分析 │
|
||
│ - Stage並行 │ │ - 3者見積もり比較 │
|
||
│ - ツール要件 │ │ - 1ヶ月根拠 │
|
||
└───┬──────────┘ └────────────────────────┘
|
||
│
|
||
│ 実践↓
|
||
│
|
||
┌───▼──────────────────────────────────────┐
|
||
│ TODO.md │
|
||
│ （今すぐやること） │
|
||
│ - Phase 1（MirCall）小粒タスク │
|
||
│ - plugin-on スモーク拡充 │
|
||
│ - HostHandleRouter 段階移設 │
|
||
└───────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 🗺️ **Phase 15.75 完全手順マップ**
|
||
|
||
### **Phase 0（今）: 準備・計画確認**
|
||
```
|
||
✅ ドキュメント読了
|
||
1. INDEX.md（このファイル）
|
||
2. TODO.md
|
||
3. ROADMAP.md
|
||
|
||
✅ 環境確認
|
||
- スモークテスト実行: bash tools/smokes/v2/run.sh --profile quick-selfhost
|
||
- 現状: 170/185 PASS（15 FAIL）
|
||
```
|
||
|
||
### **Phase 1: Hakorune VM完成（MirCall実装）**
|
||
```
|
||
📋 Phase 1タスク:
|
||
- TODO.md の「Phase 1（MirCall）着手準備」参照
|
||
- 小粒・箱化方針で段階実装
|
||
- 15/16命令 → 16/16命令（100%完成）
|
||
```
|
||
|
||
### **Phase 2: Selfhost Parser実装**
|
||
```
|
||
📋 Phase 2タスク:
|
||
- Parser.hako 実装
|
||
- MIR出力確認（Rust Parser と一致）
|
||
- 詳細は ROADMAP.md 参照
|
||
```
|
||
|
||
### **Phase 3: Boxes Migration（進行中）**
|
||
```
|
||
🔄 現状: P3-4（レガシー撤退）
|
||
✅ ChatGPT担当
|
||
📋 詳細: PHASE_3_BOXES_MIGRATION.md
|
||
```
|
||
|
||
### **Phase 4: Dual Parser Harness（次のフェーズ）**
|
||
```
|
||
🎯 目標: Rust Parser層を100-200行のC ABI層に縮退
|
||
|
||
📚 完全ドキュメント: stage-4/ フォルダ
|
||
- INDEX.md - エントリーポイント
|
||
- QUICKSTART.md - 3行要約 + 2日間スケジュール
|
||
- C_ABI_DESIGN_SPEC.md - C ABI層設計
|
||
- HAKO_ABI_DESIGN_SPEC.md - Hako ABI層設計
|
||
- TECHNICAL_REQUIREMENTS.md - 技術要件
|
||
- SCHEDULE.md - 詳細スケジュール
|
||
- RISK_ANALYSIS.md - リスク分析
|
||
|
||
👉 次のアクション: cd stage-4/ && cat INDEX.md
|
||
```
|
||
|
||
### **Phase 5以降**
|
||
```
|
||
🔄 Phase 5: Parser完全移行（1週間）
|
||
🔄 Phase 6-N: 他のコンポーネントも同様にC ABI化
|
||
|
||
※ ROADMAP.md 参照
|
||
```
|
||
|
||
---
|
||
|
||
## 📝 **各ドキュメントの詳細情報**
|
||
|
||
| ドキュメント | サイズ | 読了時間 | 優先度 | 役割 |
|
||
|-------------|--------|---------|--------|------|
|
||
| **INDEX.md** | 11KB | 3分 | ★★★★★ | エントリーポイント |
|
||
| **TODO.md** | 7.4KB | 5分 | ★★★★★ | 今すぐやること |
|
||
| **ROADMAP.md** | 41KB | 15-20分 | ★★★★ | 全体戦略＋タスクリスト |
|
||
| **STRATEGY.md** | 30KB | 15分 | ★★★★ | 安全性保証＋ツール |
|
||
| **ANALYSIS.md** | 18.2KB | 10分 | ★★★ | 実績分析＋見積もり |
|
||
| **stage-4/** | 165KB | 2時間 | ★★★★ | Stage 4完全設計 |
|
||
| **PHASE_3_BOXES_MIGRATION.md** | 1.9KB | 3分 | ★★★ | Stage 3進行状況 |
|
||
|
||
---
|
||
|
||
## 🚨 **よくある質問（FAQ）**
|
||
|
||
### Q1: どこから読めばいいの？
|
||
**A**: 👉 **[TODO.md](./TODO.md)** から始めてください（5分で読める）
|
||
|
||
### Q2: Phase 15.75って何？
|
||
**A**: Rust 99,406行 → 10,400行（89.5%削減）する計画です。詳細は [ROADMAP.md](./ROADMAP.md) 参照
|
||
|
||
### Q3: 失敗したらどうなるの？
|
||
**A**: MIR疎結合により、いつでもRollback可能です。詳細は [STRATEGY.md](./STRATEGY.md) 参照
|
||
|
||
### Q4: いつから始めるの？
|
||
**A**: **今すぐ**始められます。[TODO.md](./TODO.md) の「次アクション」参照
|
||
|
||
### Q5: どのくらい時間がかかるの？
|
||
**A**: **1ヶ月計画**（Phase 1-2コア完了）。詳細は [ANALYSIS.md](./ANALYSIS.md) 参照
|
||
|
||
### Q6: 1ヶ月で本当に可能？
|
||
**A**: Git履歴の実績ベースで可能です。詳細は [ANALYSIS.md](./ANALYSIS.md) 参照
|
||
|
||
### Q7: Stage 4（Dual Parser Harness）って何？
|
||
**A**: Rust Parser層を100-200行のC ABI層に縮退するフェーズです。詳細は [stage-4/INDEX.md](./stage-4/INDEX.md) 参照
|
||
|
||
---
|
||
|
||
## 🔗 **関連ドキュメント（外部リンク）**
|
||
|
||
### **上位ドキュメント**
|
||
- [00_MASTER_ROADMAP.md](../00_MASTER_ROADMAP.md) - Hakorune全体のマスタープラン
|
||
- [CURRENT_TASK.md](../../../../CURRENT_TASK.md) - 現在進行状況
|
||
|
||
### **参考ドキュメント**
|
||
- [INSTRUCTION_SET.md](../../../../reference/mir/INSTRUCTION_SET.md) - MIR命令セット
|
||
- [実行モード完全ガイド](../../../../guides/execution-modes-guide.md) - VM/LLVM/WASM実行
|
||
|
||
---
|
||
|
||
## 📋 **次のアクション（明確な手順）**
|
||
|
||
### **ステップ1: 理解する（30分）**
|
||
```bash
|
||
# 1. このファイル（INDEX.md）を読む（3分）✅ 完了！
|
||
# 2. TODO.md を読む（5分）
|
||
cat TODO.md
|
||
|
||
# 3. ROADMAP を流し読み（15分）
|
||
less ROADMAP.md
|
||
|
||
# 4. STRATEGY を流し読み（10分）
|
||
less STRATEGY.md
|
||
```
|
||
|
||
### **ステップ2: 現状確認（10分）**
|
||
```bash
|
||
# スモークテスト実行
|
||
bash tools/smokes/v2/run.sh --profile quick-selfhost
|
||
|
||
# 期待: 170/185 PASS（現状維持）
|
||
```
|
||
|
||
### **ステップ3: 作業開始（TODO.mdベース）**
|
||
```bash
|
||
# TODO.md の「次アクション」を1つずつ実行
|
||
# Phase 1（MirCall）小粒タスクから開始
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 **まとめ: Phase 15.75 を1行で説明**
|
||
|
||
```
|
||
Rust 99,406行 → 10,400行（89.5%削減）を1ヶ月で実現する、
|
||
MIR疎結合により失敗時Rollback可能なゼロリスク計画
|
||
```
|
||
|
||
---
|
||
|
||
## 📝 **変更履歴**
|
||
|
||
- 2025-10-14: ファイル整理（9→5ファイルに削減）
|
||
- QUICKSTART.md を INDEX.md に統合
|
||
- ROADMAP.md, STRATEGY.md, ANALYSIS.md 作成
|
||
- リンク修正完了
|
||
|
||
- 2025-10-13: 初版作成（Claude Code）
|
||
- 4つのドキュメントの整理・導線設計
|
||
- 読む順番と優先度の明確化
|
||
- FAQ・手順マップ追加
|