docs: restore docs/private/roadmap from 7b4908f9 (Phase 20.31)

2025-10-31 18:00:10 +09:00
parent 1d49e24bf0
commit 8fd3a2b509
433 changed files with 108935 additions and 0 deletions
--- a/docs/private/roadmap/phases/phase-20-python-integration/INDEX.md
+++ b/docs/private/roadmap/phases/phase-20-python-integration/INDEX.md
@ -0,0 +1,203 @@
+# Phase 20 Python Integration - INDEX
+
+## 📋 全体概要
+
+**Phase 20: Python-Hakorune統合** - PythonのAST/木構造をHakoruneに落とし、Python-Hakorune間の相互運用を実現するフェーズです。
+
+**出典**: 旧Phase 10.5（Phase 10.1系）の内容を整理・再編成
+
+## 🗂️ フォルダ構成
+
+```
+phase-20-python-integration/
+├── README.md                           # ⭐ メインドキュメント
+├── INDEX.md                            # このファイル
+│
+├── 📁 planning/                        # 計画・設計
+│   ├── README.md
+│   ├── integrated-plan.md              # ChatGPT5統合計画
+│   ├── python-parser-plan-summary.md   # パーサー計画サマリー
+│   ├── python-parser-box-design.md     # パーサーBox設計
+│   └── expert-feedback.md              # AI専門家フィードバック
+│
+├── 📁 parser-integration/              # パーサー統合
+│   ├── README.md
+│   ├── implementation-plan.md          # 実装計画
+│   └── builtin-box-flow.md             # ビルトインBox実装フロー
+│
+├── 📁 core-implementation/             # コア実装
+│   ├── README.md
+│   └── implementation-roadmap.md       # 実装ロードマップ
+│
+├── 📁 transpiler/                      # トランスパイラー
+│   ├── README.md
+│   └── python-to-hakorune-spec.md      # Python→Hakorune変換仕様
+│
+├── 📁 design/                          # 設計ドキュメント
+│   ├── README.md
+│   ├── abi-design.md                   # ABI設計
+│   ├── native-build-consolidation.md   # ネイティブビルド
+│   └── handle-first-plugininvoke-plan.md # Handle-First設計
+│
+├── 📁 testing/                         # テスト計画
+│   └── README.md
+│
+└── 📁 documentation/                   # ドキュメント計画
+    └── README.md
+```
+
+## 🎯 クイックナビゲーション
+
+### 🚀 初めての方へ
+1. [メインREADME](README.md) - 全体概要を理解
+2. **[強化版アーキテクチャv2](design/enhanced-architecture-v2.md)** - ChatGPT Pro最新設計（推奨）
+3. [マイルストーン](planning/milestones.md) - M0〜M6実装計画
+4. [Planning README](planning/README.md) - 計画の詳細を確認
+5. [統合計画](planning/integrated-plan.md) - ChatGPT5による詳細計画
+
+### 🏗️ 設計を知りたい
+- **[強化版アーキテクチャv2](design/enhanced-architecture-v2.md)** ⭐ ChatGPT Pro最新設計（2025-10-02）
+- [ABI設計](design/abi-design.md) - Python-Hakorune間のABI
+- [Handle-First設計](design/handle-first-plugininvoke-plan.md) - プラグイン呼び出し設計
+- [ネイティブビルド](design/native-build-consolidation.md) - AOT/EXE生成
+- [メタ設定例](design/meta-config-examples.md) - hako.toml設定リファレンス
+- [リスクと対策](design/risks-and-mitigations.md) - 既知のリスクと対策
+
+### 💻 実装を見たい
+- [パーサー実装計画](parser-integration/implementation-plan.md) - PythonパーサーBox
+- [コア実装ロードマップ](core-implementation/implementation-roadmap.md) - PyRuntimeBox/PyObjectBox
+- [トランスパイラー仕様](transpiler/python-to-hakorune-spec.md) - Python→Hakorune変換
+
+### 🧪 テストについて
+- [テスト計画](testing/README.md) - テスト戦略とチェックリスト
+
+### 📚 ドキュメントについて
+- [ドキュメント計画](documentation/README.md) - ドキュメント構成
+
+## 📊 実装ステータス
+
+| カテゴリ | コンポーネント | ステータス |
+|---------|--------------|----------|
+| **計画** | 設計・計画書 | ✅ 完了 |
+| **計画** | 強化版アーキテクチャv2 | ✅ 完了（2025-10-02）|
+| **計画** | マイルストーン（M0-M6） | ✅ 完了（2025-10-02）|
+| **設計** | ABI設計 | ✅ 完了 |
+| **設計** | Handle-First | ✅ 完了 |
+| **設計** | ネイティブビルド | ✅ 完了 |
+| **設計** | メタ設定例 | ✅ 完了（2025-10-02）|
+| **設計** | リスク管理 | ✅ 完了（2025-10-02）|
+| **実装** | PyRuntimeBox | 📅 未実装（M0予定）|
+| **実装** | PyObjectBox | 📅 未実装（M0予定）|
+| **実装** | PythonパーサーBox | 📅 未実装（M4予定）|
+| **実装** | トランスパイラー | 📅 未実装 |
+| **テスト** | ユニットテスト | 📅 未実装 |
+| **テスト** | 統合テスト | 📅 未実装 |
+| **ドキュメント** | ユーザーガイド | 📅 未実装 |
+| **ドキュメント** | APIリファレンス | 📅 未実装 |
+
+## 🎯 主要コンポーネント
+
+### 1. PyRuntimeBox
+**目的**: Python実行環境の提供
+
+```hakorune
+box PyRuntimeBox {
+    eval(code: StringBox) -> PyObjectBox
+    import(name: StringBox) -> PyObjectBox
+}
+```
+
+### 2. PyObjectBox
+**目的**: Pythonオブジェクトの管理
+
+```hakorune
+box PyObjectBox {
+    getattr(name: StringBox) -> PyObjectBox
+    setattr(name: StringBox, value: PyObjectBox)
+    call(args: ArrayBox) -> PyObjectBox
+    to_string() -> StringBox
+    to_int() -> IntegerBox
+}
+```
+
+### 3. PythonパーサーBox
+**目的**: Python AST → Hakorune MIR変換
+
+```hakorune
+box PythonParserBox {
+    parse(code: StringBox) -> ASTBox
+    to_hakorune_ast(ast: ASTBox) -> HakoruneASTBox
+    to_mir(ast: ASTBox) -> MIRBox
+}
+```
+
+### 4. トランスパイラー
+**目的**: Python構文 → Hakorune構文変換
+
+```hakorune
+box PythonTranspiler {
+    transpile(python_code: StringBox) -> StringBox
+}
+```
+
+## ⚠️ 現在のステータス
+
+**保留中** - Phase 15（Hakoruneセルフホスティング）完了後に着手予定
+
+### 保留理由
+1. **優先度**: まずHakorune自身の基盤を固める
+2. **依存関係**: セルフホスティング実現が先決
+3. **リソース**: 段階的に実装する方が安全
+
+### 再開条件
+- ✅ Phase 15完了（Rust VM + LLVM 2本柱体制確立）
+- ✅ セルフホスティング実現
+- ✅ プラグインシステム安定化
+
+## 🔗 関連Phase
+
+### 前提Phase
+- [Phase 15 - セルフホスティング](../phase-15/) - 現在進行中
+- [Phase 12 - TypeBox統合](../phase-12/) - 完了
+
+### 後続Phase（予定）
+- Phase 21 - 箱データベース
+- Phase 22+ - 未定
+
+## 📚 元資料
+
+このPhase 20は以下の旧資料を整理・統合したものです：
+
+- **元の場所**: `docs/archive/phases/phase-10.5/phase-10.5/`
+- **旧Phase名**: Phase 10.5（Phase 10.1系を再編成）
+- **作成時期**: 2025年8月頃
+- **主要貢献者**: ChatGPT5, Gemini, Codex
+
+## 🎯 将来の展望
+
+### 短期目標（Phase 15後）
+1. PyRuntimeBox基本実装
+2. PyObjectBox基本実装
+3. 基本的なPython呼び出し動作
+
+### 中期目標
+1. PythonパーサーBox実装
+2. Python AST → Hakorune MIR変換
+3. トランスパイラー実装
+
+### 長期目標
+1. Python-Hakoruneシームレス統合
+2. Pythonライブラリの完全活用
+3. ハイブリッド開発の実現
+
+## 📞 お問い合わせ
+
+- **メインドキュメント**: [README.md](README.md)
+- **マスタープラン**: [00_MASTER_ROADMAP.md](../00_MASTER_ROADMAP.md)
+- **現在のフェーズ**: [Phase 15](../phase-15/)
+
+---
+
+**最終更新**: 2025-10-02
+**整理者**: Claude Code
+**ステータス**: 計画済み・実装待ち