freeze: macro platform complete; default ON with profiles; env consolidation; docs + smokes\n\n- Profiles: --profile {lite|dev|ci|strict} (dev-like default for macros)\n- Macro paths: prefer NYASH_MACRO_PATHS (legacy envs deprecated with warnings)\n- Selfhost pre-expand: auto mode, PyVM-only, add smokes (array/map)\n- Docs: user-macros updated; new macro-profiles guide; AGENTS freeze note; CURRENT_TASK freeze\n- Compat: non-breaking; legacy envs print deprecation notices\n

2025-09-19 22:27:59 +09:00
parent 811e3eb3f8
commit da32455afc
192 changed files with 6454 additions and 2973 deletions
--- a/docs/reference/core-language/design-philosophy.md
+++ b/docs/reference/core-language/design-philosophy.md
@ -0,0 +1,337 @@
+# 🌟 明示的デリゲーション革命：なぜNyashは世界初の完全明示デリゲーション言語になったのか
+
+作成日: 2025年8月11日  
+著者: Nyashプロジェクトチーム  
+ステータス: 設計思想決定版
+
+## 📜 はじめに：革命の始まり
+
+2025年8月11日、Nyashプログラミング言語の開発において、言語設計史上最大級の発見がありました。それは、**暗黙のオーバーライド問題**の発見と、それを解決する**完全明示デリゲーション構文**の誕生です。
+
+この文書は、なぜこの革命が必要だったのか、どのような思想の元に設計されたのかを詳しく解説します。
+
+## 🚨 問題の発見：暗黙の悪魔
+
+### HashMap::insert による意図しない上書き
+
+Nyashの実装を詳しく調査した結果、恐ろしい問題が発見されました：
+
+```rust
+// instance.rs - add_method関数
+pub fn add_method(&mut self, method_name: String, method_ast: ASTNode) {
+    let mut new_methods = (*self.methods).clone();
+    new_methods.insert(method_name, method_ast);  // ← 暗黙の上書き！
+    self.methods = Arc::new(new_methods);
+}
+```
+
+この実装により、以下のような**暗黙のオーバーライド**が発生していました：
+
+```nyash
+box Node {
+    send(msg) {           // 最初の定義
+        print("Version 1")
+    }
+    
+    send(msg) {          // 暗黙に上書きされる
+        print("Version 2")  // ← こちらだけが残る
+    }
+}
+```
+
+### Nyash哲学との根本的矛盾
+
+この問題は、Nyashの3つの核心哲学と完全に矛盾していました：
+
+1. **明示性重視**: 「何が起きているかを隠さない」
+2. **Everything is Box**: 「統一された世界観」  
+3. **初学者フレンドリー**: 「複雑な概念を分かりやすく表現」
+
+暗黙のオーバーライドは、これらすべてを破壊する**言語設計上の致命的欠陥**だったのです。
+
+## 💡 解決への道：3AI大会議
+
+### AI専門家による徹底分析
+
+この問題の解決策を求めて、言語設計の専門家であるGeminiとChatGPTに相談を行いました。結果は予想を上回る**圧倒的な支持**でした。
+
+#### Gemini先生の評価
+> **「全面的に賛成します」**  
+> **「極めて重要な一歩」**  
+> **「Nyashのアイデンティティを確立する」**
+
+#### ChatGPT先生の評価
+> **「強く整合する」**  
+> **「安全性と読みやすさを大幅に向上」**  
+> **「実装工数3-5日程度」**
+
+### 専門的視点からの裏付け
+
+両専門家から以下の重要な指摘がありました：
+
+1. **哲学的整合性**: Nyashの明示性哲学と完全に合致
+2. **技術的優位性**: 他言語の問題（Python MRO、Java super等）を根本解決
+3. **学習効果**: 初学者にとってより理解しやすい設計
+4. **実装可能性**: 技術的に十分実現可能
+
+## 🌟 革命的解決策：Override + From 統一構文
+
+### 4つの統一原則
+
+この問題を解決するため、以下の4つの統一原則を確立しました：
+
+#### 1. 宣言の統一
+```nyash
+box Child from Parent  // デリゲーション関係の明示
+```
+
+#### 2. 置換の統一  
+```nyash
+override methodName()  // オーバーライドの明示宣言
+```
+
+#### 3. 呼び出しの統一
+```nyash  
+from Parent.methodName()  // 親実装の明示呼び出し
+```
+
+#### 4. 構築の統一
+```nyash
+from Parent.init()  // コンストラクタも同じ構文
+```
+
+### 完全な例
+
+```nyash
+box MeshNode : P2PBox {
+    init routing = RoutingTable()
+    
+    constructor(nodeId, world) {
+        from P2PBox.constructor(nodeId, world)  // 統一構文
+        me.routing = RoutingTable()
+    }
+    
+    override send(intent, data, target) {        // 明示的置換
+        me.routing.log(target)
+        from P2PBox.send(intent, data, target)   // 明示的呼び出し
+    }
+}
+```
+
+## 🔥 革命的特徴
+
+### 1. 完全な明示性
+
+**従来の問題**：
+- 何がオーバーライドされているかわからない
+- 親のどのメソッドを呼んでいるかわからない
+- 実行順序が不明確
+
+**Nyashの解決**：
+- `override` で置換を明示宣言
+- `from Parent.method()` で呼び出し先を完全明示
+- 上から下への直感的な実行順序
+
+### 2. 曖昧性の完全排除
+
+**多重デリゲーション時の曖昧性解消**：
+```nyash
+box SmartNode : P2PBox, Logger {
+    override send(intent, data, target) {
+        from Logger.debug("Sending: " + intent)    // どのLoggerか明確
+        from P2PBox.send(intent, data, target)     // どのP2PBoxか明確
+    }
+}
+
+// 競合時は更に明示的に
+box ConflictNode from ParentA, ParentB {
+    override ParentA.process(data) {  // ParentAのprocessを置換
+        from ParentA.process(data)
+    }
+    
+    override ParentB.process(data) {  // ParentBのprocessを置換  
+        from ParentB.process(data)
+    }
+}
+```
+
+### 3. 学習コストの最小化
+
+**覚えるべきルール**：
+1. 親のメソッドを置換したい → `override`
+2. 親のメソッドを呼びたい → `from Parent.method()`
+3. 親のコンストラクタを呼びたい → `from Parent.init()`
+
+たった3つのルールで、すべてのデリゲーション操作が表現できます。
+
+## 🌍 他言語との比較：なぜNyashが優れているのか
+
+### Python の問題
+```python
+# MRO（Method Resolution Order）地獄
+class C(A, B):
+    def method(self):
+        super().method()  # どっちのmethod？
+```
+
+**Nyash の解決**：
+```nyash
+box C : A, B {
+    override method() {
+        from A.method()  // Aのmethodと明示
+        from B.method()  // Bのmethodと明示
+    }
+}
+```
+
+### Java/C# の問題
+```java
+// どの親のmethodを呼んでいるかコードから不明
+@Override
+public void method() {
+    super.method();  // 単一継承でも曖昧
+}
+```
+
+**Nyash の解決**：
+```nyash
+override method() {
+    from Parent.method()  // どのParentか完全に明確
+}
+```
+
+### TypeScript の問題
+```typescript
+// 暗黙のオーバーライドによる事故
+class Child extends Parent {
+    method() {  // うっかり同名メソッド → 意図しない上書き
+        // ...
+    }
+}
+```
+
+**Nyash の解決**：
+```nyash
+// overrideなしで同名メソッド → コンパイルエラー
+// 意図しない上書きは100%防止
+```
+
+## 🎯 設計思想の深層
+
+### Everything is Box との統合
+
+この革命は、Nyashの根本思想「Everything is Box」と完全に統合されています：
+
+- **Box同士のデリゲーション**: 階層ではなく、協力関係
+- **Boxメソッドの明示的管理**: どのBoxのどのメソッドかが常に明確  
+- **Box構築の明示的制御**: コンストラクタも普通のメソッド
+
+### 明示性の哲学
+
+Nyashが目指すのは、**「魔法のない言語」**です：
+
+- 隠れた処理は一切なし
+- すべての動作がコードに現れる
+- 初学者でも上級者でも同じように理解できる
+
+### 初学者への配慮
+
+複雑な概念を、シンプルな文法で表現：
+
+- `override` = 「置き換えます」
+- `from Parent.method()` = 「親の方法を使います」
+- コンパイルエラー = 「間違いを素早く教える」
+
+## 🚀 実装戦略
+
+### 段階的導入
+
+ChatGPT先生の提案による実装ロードマップ：
+
+**Phase 1（0.5-1日）**：
+- `override` キーワード追加
+- 基本パーサー拡張
+
+**Phase 2（1-2日）**：
+- 暗黙オーバーライド検出
+- コンストラクタ重複禁止
+
+**Phase 3（1日）**：
+- `from Parent.init()` 実装
+- エラーメッセージ改善
+
+### 移行支援
+
+既存コードの安全な移行：
+- 段階的警告システム
+- 自動修正支援ツール
+- 詳細な移行ガイド
+
+## 🌟 期待される効果
+
+### 1. 開発者体験の革命的向上
+
+**Before（暗黙オーバーライド）**：
+- バグの発見が困難
+- 意図しない動作
+- デバッグに多大な時間
+
+**After（明示的オーバーライド）**：
+- コンパイル時に間違いを検出
+- 意図が明確に表現される
+- デバッグ時間の劇的短縮
+
+### 2. コードの可読性向上
+
+**Before**：
+```nyash
+// これは何をオーバーライドしている？
+send(msg) {
+    // 親を呼んでる？呼んでない？
+    processMessage(msg)
+}
+```
+
+**After**：
+```nyash  
+// P2PBoxのsendを明示的にオーバーライド
+override send(msg) {
+    processMessage(msg)
+    from P2PBox.send(msg)  // P2PBoxの実装も使用
+}
+```
+
+### 3. 保守性の向上
+
+- 変更の影響範囲が明確
+- リファクタリングが安全
+- チーム開発での誤解を防止
+
+## 🏆 結論：言語設計史に残る革命
+
+この明示的デリゲーション革命により、Nyashは以下を達成しました：
+
+### 世界初の完全明示デリゲーション言語
+
+1. **完全な明示性**: すべての動作を明示
+2. **曖昧性の完全排除**: どんな複雑なケースも明確  
+3. **統一構文**: デリゲーションとオーバーライドの完全統合
+4. **初学者フレンドリー**: 学習しやすく、間違いにくい
+
+### プログラミング言語設計への貢献
+
+- **暗黙の悪魔**からの完全な解放
+- **多重デリゲーション**の安全で明確な実現
+- **コード可読性**の新しい基準の確立
+
+### 未来への影響
+
+Nyashのこの革命は、今後のプログラミング言語設計に大きな影響を与えるでしょう。「暗黙より明示」という哲学が、ついに技術的に完全実現されたのです。
+
+---
+
+**2025年8月11日は、プログラミング言語史において「明示的デリゲーション革命の日」として記憶されることでしょう。** 🎊
+
+この革命により、Nyashは単なるプログラミング言語を超えて、**新しいプログラミングパラダイムの先駆者**となりました。
+
+Everything is Box. Everything is Explicit. Everything is Beautiful. 🌟