c9366d5c54
Major additions:
- Phase 11.8 MIR cleanup specification (Core-15→14→13 roadmap)
- Nyash ABI unified design document (3×u64 structure)
- TaskGroupBox foundation with cancelAll/joinAll methods
- Enhanced async/await with checkpoint auto-insertion
- Structured concurrency preparation (parent-child task relationships)
Documentation:
- docs/development/roadmap/phases/phase-11.8_mir_cleanup/: Complete Core-13 path
- docs/development/roadmap/phases/phase-12/NYASH-ABI-DESIGN.md: Unified ABI spec
- Updated Phase 12 README with AOT/JIT explanation for script performance
- Added async_task_system/ design docs
Implementation progress:
- FutureBox spawn tracking with weak/strong reference management
- VM checkpoint integration before/after await
- LLVM backend async support preparation
- Verifier rules for await-checkpoint enforcement
- Result<T,E> normalization for timeout/cancellation
Technical insights:
- MIR as 'atomic instructions', Box as 'molecules' philosophy
- 'Everything is Box' enables full-stack with minimal instructions
- Unified BoxCall for array/plugin/async operations future consolidation
Next steps:
- Complete TaskGroupBox implementation
- Migrate from global to scoped task management
- Implement LIFO cleanup on scope exit
- Continue Core-13 instruction consolidation
🚀 'From 15 atoms to infinite programs: The Nyash Box Theory'
127 lines
4.3 KiB
Markdown
127 lines
4.3 KiB
Markdown
# Phase 12: Nyashコード共有エコシステム - Everything is Box の実現
|
||
|
||
## 🎯 重要な変更 (2025-09-01)
|
||
|
||
Phase 12の議論とビルトインBox廃止により、プラグインシステムが進化：
|
||
|
||
**新しい3層プラグインシステムが確立されました！**
|
||
|
||
```nyash
|
||
# Nyashスクリプトプラグイン（ユーザー定義Box）
|
||
box DataProcessor {
|
||
init {
|
||
me.file = new FileBox() # C ABIプラグイン使用
|
||
me.math = new MathBox() # C ABIプラグイン使用
|
||
me.cache = new MapBox() # これもC ABIプラグイン（ビルトイン廃止）
|
||
}
|
||
|
||
process(data) {
|
||
local result = me.math.sin(data)
|
||
me.file.write("log.txt", result.toString())
|
||
return result
|
||
}
|
||
}
|
||
|
||
# 使用例
|
||
local processor = new DataProcessor()
|
||
processor.process(3.14) # すべてプラグインで動作！
|
||
```
|
||
|
||
## 📝 なぜ誤解が生まれたのか
|
||
|
||
「プラグイン」という言葉から、特別な仕組みが必要だと考えてしまいましたが、Nyashの「Everything is Box」哲学により、ユーザー定義Boxこそが最高のプラグインシステムでした。
|
||
|
||
詳細な分析：[なぜ天才AIたちは間違えたのか](./WHY-AIS-FAILED.md)
|
||
|
||
## 🚀 Phase 12の真の価値：コード共有エコシステム
|
||
|
||
### 本当に必要なもの
|
||
|
||
1. **export/import構文**
|
||
```nyash
|
||
# math_utils.ny
|
||
export box MathUtils {
|
||
factorial(n) { ... }
|
||
fibonacci(n) { ... }
|
||
}
|
||
|
||
# main.ny
|
||
import { MathUtils } from "math_utils.ny"
|
||
local utils = new MathUtils()
|
||
```
|
||
|
||
2. **パッケージマネージャー**
|
||
```bash
|
||
nyash install awesome-math-utils
|
||
nyash publish my-cool-box
|
||
```
|
||
|
||
3. **ドキュメント生成**
|
||
```nyash
|
||
# @doc 素晴らしい数学ユーティリティ
|
||
# @param n 計算したい数値
|
||
# @return 階乗の結果
|
||
export box MathUtils { ... }
|
||
```
|
||
|
||
## 📊 新しい3層プラグインシステム
|
||
|
||
```
|
||
Nyashエコシステム（ビルトインBox廃止後）：
|
||
├── Nyashスクリプトプラグイン（ユーザー定義Box）← .nyashファイル
|
||
├── C ABIプラグイン（既存のまま使用）← シンプル・高速・安定
|
||
└── Nyash ABIプラグイン（必要時のみ）← 言語間相互運用・将来拡張
|
||
└── MIR命令は増やさない（BoxCallにabi_hint追加のみ）
|
||
```
|
||
|
||
### プラグイン選択の指針
|
||
- **C ABIで済むなら、C ABIを使う**（シンプルイズベスト）
|
||
- Nyash ABIは以下の場合のみ：
|
||
- 他言語（Python/Go等）からの呼び出し
|
||
- 複雑な型の相互運用が必要
|
||
- 将来の拡張性を重視する場合
|
||
|
||
### 📝 MIR命令統合（Phase 12での変更）
|
||
- **PluginInvoke → BoxCall 統合**
|
||
- ビルトインBox廃止によりフォールバックがなくなる
|
||
- BoxCallとPluginInvokeの区別が不要に
|
||
- VM層でC ABI/Nyash ABI/Scriptを自動判定
|
||
- Core-15 → Core-14 へ（命令数削減）
|
||
|
||
## 🛣️ 実装ロードマップ（修正版）
|
||
|
||
### Phase 12.1: export/import構文（2週間）
|
||
- [ ] exportキーワードのパーサー実装
|
||
- [ ] importステートメントの実装
|
||
- [ ] モジュール解決システム
|
||
- 📄 **[詳細仕様書](./export-import-spec.md)**
|
||
|
||
### Phase 12.2: パッケージ管理（3週間）
|
||
- [ ] nyash.tomlのdependencies対応
|
||
- [ ] 中央リポジトリ設計
|
||
- [ ] CLIツール（install/publish）
|
||
- 📄 **[パッケージマネージャー設計書](./package-manager-design.md)**
|
||
|
||
### Phase 12.3: 開発者体験向上（継続的）
|
||
- [ ] ドキュメント生成ツール
|
||
- [ ] VSCode拡張（補完・定義ジャンプ）
|
||
- [ ] サンプルパッケージ作成
|
||
|
||
## 📚 関連ドキュメント
|
||
|
||
### 🎯 主要設計ドキュメント
|
||
- **[Nyash ABI統合設計図](./NYASH-ABI-DESIGN.md)** ← 🆕 具体的な技術仕様！
|
||
- [export/import仕様](./export-import-spec.md)
|
||
- [パッケージマネージャー設計](./package-manager-design.md)
|
||
- [なぜ天才AIたちは間違えたのか](./WHY-AIS-FAILED.md)
|
||
|
||
### 📂 議論の過程
|
||
|
||
- ABI戦略議論: `abi-strategy-discussion/`
|
||
- Nyash ABI詳細: `nyash-abi-discussion/`
|
||
- 初期提案アーカイブ: `archive/`
|
||
|
||
---
|
||
|
||
*AIたちがなぜ複雑な解決策を提案したのか、その議論の過程は `archive/` ディレクトリに保存されています。良い教訓として残しておきます。*
|