# Phase 15.77 - 凍結EXE確定フェーズ

**期間**: 2025-11-09 - 2025-12-20（6週間）
**状態**: 🔜 Phase 15.76完了後開始

---

## 🎯 このフェーズで実現すること

**凍結EXE（hako-frozen-v1.exe）確定 + Rust層最小化**

1. **凍結EXE作成**: hako-frozen-v1.exe ビルド・タグ付け・配布
2. **Rust層最小化**: 99,406行 → 100-200行（VM実行エンジンのみ）
3. **単一パーサ体制**: Hakoruneパーサーのみ開発（Rust凍結）
4. **安全な試行錯誤**: いつでも凍結EXEに戻れる基盤確立

---

## 💡 このフェーズの位置づけ

### Phase 15.76で確立した「背骨」を使って実際に凍結

```
Phase 15.76（背骨確立）
├── extern_c構文実装 ✅
├── LLVM Backendプラグイン化 ✅
└── AOT導線整備（MIR JSON→.o→EXE）✅

Phase 15.77（凍結実行）← 今ここ
├── 凍結EXE作成・配布
├── Rust層最小化実行
└── 単一パーサ体制確立

Phase 15.78〜（脱Rust加速）
└── Hakoruneパーサー完全実装
```

---

## 🎯 成功基準（DoD）

### 1️⃣ 凍結EXE確定

#### ビルド・動作確認
- [ ] `hako-frozen-v1.exe` ビルド成功（Linux/macOS/Windows）
- [ ] 170 PASS維持（quick-selfhost）
- [ ] AOT導線動作確認（MIR JSON→.o→EXE）

#### タグ付け・配布
- [ ] Git tag作成（`v1.0.0-frozen`）
- [ ] 配布物生成（`hako-frozen-v1-linux-x64.tar.gz`等）
- [ ] README/LICENSE同梱
- [ ] SHA256チェックサム生成

#### 配布先
```
releases/
├── v1.0.0-frozen/
│   ├── hako-frozen-v1-linux-x64.tar.gz
│   ├── hako-frozen-v1-macos-arm64.tar.gz
│   ├── hako-frozen-v1-windows-x64.zip
│   ├── SHA256SUMS.txt
│   └── INSTALL.md
```

### 2️⃣ Rust層最小化

#### 目標
```
現状: 99,406行（Phase 15.75開始時）
↓
削減: 89.5%
↓
目標: 100-200行（VM実行エンジンのみ）
```

#### 段階的削減計画
```rust
// Week 1-2: Parser削除（凍結EXE内のみ残す）
src/front/parser_layer/    ❌ 削除（凍結EXE経由）
src/front/ast/             ❌ 削除（MIR直接生成へ）

// Week 3-4: MIR Builder削除（Hakorune実装へ）
src/backend/mir_builder/   ❌ 削除（Hakorune実装使用）

// 残すもの（100-200行）
src/backend/mir_interpreter/  ✅ 残す（VM実行エンジン）
src/runtime/ffi/              ✅ 残す（extern_c基盤）
src/main.rs                   ✅ 残す（エントリーポイント）
```

### 3️⃣ 単一パーサ体制確立

#### Hakoruneパーサーをデフォルトへ
- [ ] `apps/selfhost-compiler/` をデフォルト呼び出し
- [ ] Rustパーサーは凍結EXE内のみ（緊急時用）
- [ ] スモークテスト全緑（Hakoruneパーサー使用）

#### 2重メンテ回避
```
Before（Phase 15.76以前）:
├── Rustパーサー（開発中）
└── Hakoruneパーサー（開発中）← 2重メンテ地獄

After（Phase 15.77）:
├── Rustパーサー（凍結、緊急時のみ）
└── Hakoruneパーサー（開発中）← 単一開発ライン
```

### 4️⃣ ドキュメント整備

#### 使用ガイド
- [ ] `docs/guides/frozen-toolchain-usage.md` - 凍結EXE使用方法
- [ ] `docs/guides/rust-minimization.md` - Rust最小化手順
- [ ] `INSTALL.md` - 配布物インストールガイド

#### 運用マニュアル
- [ ] 凍結EXEへの戻り方
- [ ] トラブルシューティング
- [ ] FAQ（よくある質問）

---

## 📊 週次計画（Week 1-6）

### Week 1（2025-11-09 - 11-15）凍結EXE作成

**目標**: hako-frozen-v1.exe ビルド・動作確認

#### タスク
- [ ] Phase 15.76の成果物確認（extern_c/AOT導線）
- [ ] ビルド設定整備（Cargo.toml, build.rs）
- [ ] クロスコンパイル設定（Linux/macOS/Windows）
- [ ] 動作確認（quick-selfhost 170 PASS）

#### 成果物
```bash
./hako-frozen-v1 --version
# Hakorune v1.0.0-frozen (2025-11-15)

./hako-frozen-v1 program.hako
# OK (VM実行)

./hako-frozen-v1 --backend llvm program.hako
# OK (LLVM AOT)
```

### Week 2（2025-11-16 - 11-22）タグ付け・配布物生成

**目標**: Git tag作成・配布物公開

#### タスク
- [ ] Git tag作成（`v1.0.0-frozen`）
- [ ] 配布物生成スクリプト作成
- [ ] SHA256チェックサム生成
- [ ] INSTALL.md作成

#### 成果物
```
releases/v1.0.0-frozen/
├── hako-frozen-v1-linux-x64.tar.gz    (12MB)
├── hako-frozen-v1-macos-arm64.tar.gz  (10MB)
├── hako-frozen-v1-windows-x64.zip     (15MB)
├── SHA256SUMS.txt
└── INSTALL.md
```

### Week 3（2025-11-23 - 11-29）Rust Parser削除

**目標**: Parser削除、凍結EXE経由に切り替え

#### タスク
- [ ] `src/front/parser_layer/` 削除準備
- [ ] 凍結EXE経由のParser呼び出し実装
- [ ] AST→MIR直接生成経路確立
- [ ] スモークテスト修正（Parser経路変更）

#### 削減予想
```
Before: 99,406行
After:  ~50,000行（Parser削除、約50%削減）
```

### Week 4（2025-11-30 - 12-06）MIR Builder削除準備

**目標**: MIR Builder Hakorune実装へ移行開始

#### タスク
- [ ] `apps/selfhost-compiler/mir_builder/` 検証
- [ ] Rust MIR Builder削除可能性確認
- [ ] ブリッジ層実装（Hakorune→Rust）
- [ ] 並行動作確認（Rust/Hakorune両方）

#### 削減予想
```
Before: ~50,000行
After:  ~5,000行（MIR Builder削除、約90%削減）
```

### Week 5（2025-12-07 - 12-13）Hakoruneパーサー移行

**目標**: Hakoruneパーサーをデフォルトへ

#### タスク
- [ ] `apps/selfhost-compiler/` をデフォルト呼び出し
- [ ] Rustパーサーを緊急時用に格下げ
- [ ] スモークテスト全緑確認（Hakorune使用）
- [ ] パフォーマンス計測（Rust vs Hakorune）

#### 期待結果
```bash
# デフォルト: Hakoruneパーサー
./hako program.hako  # Hakorune経由

# 緊急時: Rustパーサー（凍結EXE内）
./hako --fallback-rust-parser program.hako  # Rust経由
```

### Week 6（2025-12-14 - 12-20）ドキュメント・レビュー

**目標**: ドキュメント整備・統合テスト

#### タスク
- [ ] 凍結EXE使用ガイド作成
- [ ] Rust最小化手順書作成
- [ ] トラブルシューティングFAQ作成
- [ ] 統合テスト（quick-selfhost 全緑）
- [ ] ChatGPT/Claudeレビュー

#### 成果物
```
docs/guides/
├── frozen-toolchain-usage.md     # 使用方法
├── rust-minimization.md          # 最小化手順
└── frozen-toolchain-faq.md       # FAQ

docs/private/roadmap/phases/phase-15.77/
├── README.md                     # Phase概要
├── MILESTONE.md                  # ゴールライン
├── RUST_MINIMIZATION_PLAN.md     # 最小化計画
└── COMPLETION_REPORT.md          # 完了報告
```

---

## ❌ Out of Scope（このフェーズではやらない）

### 完全なRust削除
- VM実行エンジンは残す（100-200行）
- 理由: VM安定性・パフォーマンス

### Hakoruneパーサー完全実装
- 段階的移行（並行動作期間あり）
- 理由: 安全な移行を優先

### プロダクション配布
- まだ実験段階（v1.0.0-frozen）
- 理由: Phase 15.78以降で安定化

### Windows完全サポート
- Linux/macOS優先
- 理由: 開発環境がLinux/WSL中心

---

## 🚀 次のフェーズ（Phase 15.78〜）

### Phase 15.78: Hakoruneパーサー完全実装
- 全構文サポート（macro/async/await等）
- Rustパーサーとの完全パリティ
- パフォーマンス最適化

### Phase 15.79: 完全な脱Rust
- VM実行エンジンもHakorune実装へ
- Rust層完全削除（0行）
- Pure Hakorune達成

### Phase 15.80: プロダクション化
- v2.0.0リリース
- 安定性・セキュリティ監査
- 公式配布開始

---

## ⚠️ リスク & 対策

### リスク1: 凍結EXEのサイズ
**問題**: 静的リンクで15MB超の可能性
**対策**: 動的リンク検討、圧縮配布

### リスク2: クロスコンパイル失敗
**問題**: Windows/macOSビルドが難しい
**対策**: Linux優先、他環境は次フェーズ

### リスク3: Rust削除時の不安定化
**問題**: 削除作業でテスト失敗増加
**対策**: 段階的削除、各段階でテスト確認

### リスク4: Hakoruneパーサーの未熟
**問題**: Rustパーサーと完全パリティ未達
**対策**: 並行動作期間を長く取る、Rustフォールバック維持

---

## 📚 関連リソース

### 前フェーズ
- [Phase 15.76 - extern_c & Frozen Toolchain](../phase-15.76/)
- [Phase 15.75 - 脱Rust大作戦](../phase-15.75/)

### 論文資料
- [Rapid Self-Hosting Paper](../../../../private/papers-active/rapid-selfhost-ai-collaboration/)
- [Frozen Toolchain Pattern Evidence](../../../../private/papers-active/rapid-selfhost-ai-collaboration/03_DATA_ANALYSIS.md)

### 業界標準パターン
- **Rust**: stage0（凍結ツールチェーン）
- **Go**: Go 1.4 frozen（bootstrap用）
- **OCaml**: ocamlc frozen（自己ホスト用）

---

## 💬 開発体制

### 実装担当
- **ChatGPT**: Rust削除・Hakorune実装主導
- **Claude**: レビュー・ドキュメント整備
- **tomoaki**: 戦略判断・方向決定

### レビュー方針
- 各Week終了時にレビュー
- 170 PASS維持を最優先
- 問題発生時は即座に凍結EXEへロールバック

---

**作成日**: 2025-10-14
**Phase開始予定**: 2025-11-09（Phase 15.76完了後）
**想定期間**: 6週間