pyvm: implement TypeOp(check) + strict match-guard smokes; parser: guard support in match; llvm: PHI wiring at block head + incoming normalization; docs: AGENTS LLVM/PHI + guard policy; add tests; plan: refactor parse_box_declaration + TODO triage + clone reduction + CLI split + LLVM builder split; update CURRENT_TASK.md
This commit is contained in:
Selfhosting Dev
@ -0,0 +1,200 @@
|
||||
# ChatGPT追加マクロ案 - 客観的分析と実装優先度
|
||||
|
||||
**分析日**: 2025-09-18
|
||||
**分析対象**: ChatGPTが提案した6つの追加マクロ
|
||||
**評価基準**: 実装コスト × 実用性 × Nyash差別化
|
||||
|
||||
## 📊 総合評価マトリックス
|
||||
|
||||
| マクロ | 実装コスト | 実用性 | Nyash差別化 | 即効性 | 総合評価 | 推奨順位 |
|
||||
|--------|------------|--------|-------------|--------|----------|----------|
|
||||
| **@test / @bench** | ⭐⭐ 低 | ⭐⭐⭐⭐⭐ 最高 | ⭐⭐⭐⭐ 高 | ⭐⭐⭐⭐⭐ 即座 | **A+** | 🥇 **1位** |
|
||||
| **@serde(Json)** | ⭐⭐ 低 | ⭐⭐⭐⭐⭐ 最高 | ⭐⭐ 普通 | ⭐⭐⭐⭐⭐ 即座 | **A** | 🥈 **2位** |
|
||||
| **@derive(Builder)** | ⭐⭐⭐ 中 | ⭐⭐⭐⭐ 高 | ⭐⭐⭐⭐⭐ 最高 | ⭐⭐⭐⭐ 高 | **A** | 🥈 **2位** |
|
||||
| **@using(resource)** | ⭐⭐⭐⭐ 高 | ⭐⭐⭐⭐⭐ 最高 | ⭐⭐⭐⭐⭐ 最高 | ⭐⭐⭐ 中 | **A-** | 🥉 **4位** |
|
||||
| **@log(entry\\|exit)** | ⭐⭐⭐ 中 | ⭐⭐⭐⭐ 高 | ⭐⭐⭐ 中 | ⭐⭐⭐⭐ 高 | **B+** | **5位** |
|
||||
| **@state_machine** | ⭐⭐⭐⭐⭐ 最高 | ⭐⭐⭐ 中 | ⭐⭐⭐⭐⭐ 最高 | ⭐ 低 | **B** | **6位** |
|
||||
|
||||
## 🥇 第1位: @test / @bench（推奨度: A+）
|
||||
|
||||
### 優れている点
|
||||
- **実装コスト超低**: 関数収集 + ランナーのみ
|
||||
- **即座の価値**: 言語の信頼性が即座に向上
|
||||
- **差別化要素**: TestBoxによる統一的テスト表現
|
||||
|
||||
### 具体的価値
|
||||
```nyash
|
||||
// シンプルで強力
|
||||
@test
|
||||
method test_user_creation() {
|
||||
local user = new UserBox("Alice", 25)
|
||||
assert user.name == "Alice"
|
||||
}
|
||||
|
||||
@bench
|
||||
method bench_sorting() {
|
||||
// ベンチマーク対象処理
|
||||
}
|
||||
|
||||
// コマンド一発実行
|
||||
$ nyash test # 全テスト実行
|
||||
$ nyash bench # 全ベンチマーク実行
|
||||
```
|
||||
|
||||
### 戦略的重要性
|
||||
- **言語エコシステム**: テストがあることで他開発者の信頼獲得
|
||||
- **CI/CD統合**: 自動テスト実行でプロダクション準備
|
||||
- **品質保証**: バグ早期発見でユーザー体験向上
|
||||
|
||||
## 🥈 第2位(同率): @serde(Json)（推奨度: A）
|
||||
|
||||
### 優れている点
|
||||
- **実装コスト超低**: 既存@derive(Json)の拡張
|
||||
- **実用性最高**: Web開発で100%必要
|
||||
- **即座の価値**: APIアプリがすぐ作れる
|
||||
|
||||
### 具体的価値
|
||||
```nyash
|
||||
@serde(Json)
|
||||
box ApiResponseBox {
|
||||
status: IntegerBox
|
||||
data: UserBox
|
||||
timestamp: StringBox
|
||||
}
|
||||
|
||||
// 自動生成
|
||||
method toJson() -> JsonBox { /* 自動実装 */ }
|
||||
method fromJson(json: JsonBox) -> ApiResponseBox { /* 自動実装 */ }
|
||||
```
|
||||
|
||||
### 戦略的重要性
|
||||
- **Web開発必須**: 現代のアプリ開発で避けて通れない
|
||||
- **API統合**: 他サービスとの連携が簡単
|
||||
- **実用性証明**: 「Nyashで実用アプリが作れる」証明
|
||||
|
||||
## 🥈 第2位(同率): @derive(Builder)（推奨度: A）
|
||||
|
||||
### 優れている点
|
||||
- **Nyash独自性**: Everything is Box と完璧整合
|
||||
- **DX革命**: 複雑オブジェクト構築が劇的に改善
|
||||
- **差別化**: BoxBuilderパターンは他言語にない
|
||||
|
||||
### 具体的価値
|
||||
```nyash
|
||||
@derive(Builder)
|
||||
box HttpRequestBox {
|
||||
url: StringBox
|
||||
method: StringBox
|
||||
headers: MapBox
|
||||
body: StringBox
|
||||
timeout: IntegerBox
|
||||
}
|
||||
|
||||
// 自動生成される美しい API
|
||||
local request = HttpRequestBox.builder()
|
||||
.url("https://api.example.com")
|
||||
.method("POST")
|
||||
.header("Content-Type", "application/json")
|
||||
.body(json_data)
|
||||
.timeout(5000)
|
||||
.build()
|
||||
```
|
||||
|
||||
### 戦略的重要性
|
||||
- **API設計**: Fluent APIで開発者体験が革命的改善
|
||||
- **複雑性管理**: 引数多数のBoxが扱いやすくなる
|
||||
- **独自価値**: 他言語から開発者を引き寄せる魅力
|
||||
|
||||
## 🥉 第4位: @using(resource)（推奨度: A-）
|
||||
|
||||
### 優れている点
|
||||
- **理論的完璧性**: cleanup理論との整合性
|
||||
- **安全性革命**: リソースリーク完全防止
|
||||
- **独自性**: Box統合RAII は革新的
|
||||
|
||||
### 実装コストが高い理由
|
||||
- **スコープ管理**: 複雑なライフタイム追跡
|
||||
- **例外安全**: throw発生時の確実なcleanup
|
||||
- **コンパイラ統合**: 深い言語機能統合が必要
|
||||
|
||||
### 具体的価値
|
||||
```nyash
|
||||
// 美しく安全なリソース管理
|
||||
@using(file = new FileBox("data.txt"))
|
||||
method process_file() {
|
||||
// ファイルが確実にcloseされる
|
||||
// throwが発生してもcleanup実行
|
||||
}
|
||||
```
|
||||
|
||||
### 実装推奨タイミング
|
||||
- **Phase 16.7以降**: 基本マクロ安定後
|
||||
- **cleanup機能充実後**: 既存cleanup実装の拡張として
|
||||
|
||||
## 第5位: @log(entry|exit)（推奨度: B+）
|
||||
|
||||
### 良い点
|
||||
- **デバッグ効率**: トレース情報で問題解決加速
|
||||
- **AOP入口**: Aspect指向プログラミングの基盤
|
||||
- **運用監視**: プロダクションでの監視基盤
|
||||
|
||||
### 課題点
|
||||
- **実装複雑**: メソッド呼び出し前後の処理注入
|
||||
- **パフォーマンス**: ログ出力によるオーバーヘッド
|
||||
- **差別化弱**: Java・C#等に既存機能
|
||||
|
||||
### 実装推奨タイミング
|
||||
- **Phase 16.8以降**: AOP基盤構築後
|
||||
|
||||
## 第6位: @state_machine（推奨度: B）
|
||||
|
||||
### 革新性は最高だが...
|
||||
- **独自性**: 他言語にほぼ存在しない革新的機能
|
||||
- **ドメイン価値**: ゲーム・UI・ワークフロー等で強力
|
||||
- **型安全**: 状態遷移の安全性保証
|
||||
|
||||
### 実装コストが最高の理由
|
||||
- **複雑なDSL**: 状態遷移表の構文設計
|
||||
- **コード生成**: 複雑な状態管理コード生成
|
||||
- **検証**: 無限ループ・デッドロック等の検出
|
||||
|
||||
### 実装推奨タイミング
|
||||
- **Phase 17以降**: マクロシステム成熟後
|
||||
- **特定ドメイン**: ゲーム・UI等の具体ニーズ出現後
|
||||
|
||||
## 📋 実装推奨ロードマップ（低コスト順）
|
||||
|
||||
### Phase 16.6-16.7: 即効3マクロ
|
||||
1. **@test / @bench**（1週間）: 言語信頼性向上
|
||||
2. **@serde(Json)**（0.5週間）: @derive(Json)拡張として
|
||||
3. **@derive(Builder)**（1.5週間）: DX革命の実現
|
||||
|
||||
### Phase 16.8-16.9: 高価値マクロ
|
||||
4. **@using(resource)**（2-3週間）: cleanup理論完成
|
||||
5. **@log(entry|exit)**（1-2週間）: AOP基盤構築
|
||||
|
||||
### Phase 17以降: 革新マクロ
|
||||
6. **@state_machine**（4-6週間）: 差別化の切り札
|
||||
|
||||
## 🎯 客観的結論
|
||||
|
||||
### ChatGPT案の評価
|
||||
- **戦略的に優秀**: 低コスト・高価値を適切に選別
|
||||
- **実装順序も的確**: 即効性のあるものを優先
|
||||
- **Nyash哲学との整合**: Box統合を意識した提案
|
||||
|
||||
### 推奨アクション
|
||||
1. **@test/@bench**: Phase 16.6で即座実装開始
|
||||
2. **@serde(Json)**: @derive(Json)と統合実装
|
||||
3. **@derive(Builder)**: DX向上の切り札として優先
|
||||
|
||||
### 長期戦略
|
||||
- **Phase 16**: 基本3マクロで実用性確立
|
||||
- **Phase 17**: 高度マクロで差別化実現
|
||||
- **Phase 18**: @state_machine等で他言語を圧倒
|
||||
|
||||
---
|
||||
|
||||
**結論: ChatGPTの追加マクロ案は『低コスト・高価値』の原則に合致した優秀な戦略提案**
|
||||
|
||||
*客観的分析により、段階的実装による確実な価値提供戦略であることが確認された。*
|
||||
@ -0,0 +1,204 @@
|
||||
# ChatGPT最強思考モード - Macro System分析結果
|
||||
|
||||
**日時**: 2025-09-18
|
||||
**モード**: ChatGPT最強思考モード
|
||||
**評価対象**: Nyash Box-Based Macro Systemの6つの具体例
|
||||
|
||||
## 🎯 総評：「どれもNyashにドンピシャ」
|
||||
|
||||
ChatGPTによる**妥当性 × 優先度**の完全分析結果
|
||||
|
||||
| マクロ | 何に効く | 価値 | 実装コスト | リスク | 結論 |
|
||||
|--------|----------|------|------------|--------|------|
|
||||
| **@derive(Equals, ToString, Clone, Json)** | ボイラープレート除去 | ⭐⭐⭐⭐ | ⭐⭐ | ⭐ | **最優先**（MVP） |
|
||||
| **@validate（@email, @range…）** | 型安全・入力品質 | ⭐⭐⭐⭐ | ⭐⭐〜⭐⭐⭐ | ⭐⭐ | 早期導入（第2弾） |
|
||||
| **@config_schema / @env** | 実アプリ即効 | ⭐⭐⭐⭐ | ⭐⭐ | ⭐ | 早期導入（第2弾） |
|
||||
| **@api_client(openapi)** | プロダクション導線 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ | 設計しつつ段階導入 |
|
||||
| **@sql_schema（型安全SQL）** | 企業利用の決め手 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ | PoC→段階導入 |
|
||||
| **@html_dsl（DSL生成）** | 表現力・デモ力 | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ | 実験枠（後回し） |
|
||||
|
||||
### 🚀 最重要結論
|
||||
> まずは **@derive / @validate / @config_schema** で**日常開発が一気に楽になる**線から入るのがおすすめ。
|
||||
|
||||
## 🧠 革命的技術提案：HIRパッチ式マクロエンジン
|
||||
|
||||
### アーキテクチャ
|
||||
```
|
||||
Parse → HIR → (Macro Expansion) → TypeCheck → MIR(Core-13) → Backends
|
||||
```
|
||||
|
||||
### 天才的な設計原則
|
||||
- **マクロはHIR上の「差分パッチ」として実行**
|
||||
- **生成物は普通のBox/メソッド定義**
|
||||
- **MIRには一切新命令を足さない**
|
||||
|
||||
### API設計（擬似）
|
||||
```nyash
|
||||
box MacroContext { /* gensym, type info, report, file path, etc. */ }
|
||||
box DeriveMacroBox {
|
||||
expand(target: BoxAst, ctx: MacroContext) -> PatchAst
|
||||
}
|
||||
```
|
||||
|
||||
### 衛生（Hygiene）設計
|
||||
- **生成名**: `ctx.gensym("get_", name)`で一意化
|
||||
- **シンボル参照**: 明示インポートのみ許可（暗黙捕捉禁止）
|
||||
|
||||
### 決定性 & サンドボックス
|
||||
- **デフォルト制限**: ネットワーク禁止・時刻禁止（再現性保証）
|
||||
- **能力宣言**: `@macro(cap_net)`で外部アクセス許可
|
||||
|
||||
## 🌟 Property System完全統合
|
||||
|
||||
### 後置ヘッダ方式との整合
|
||||
```nyash
|
||||
@derive(Equals, ToString)
|
||||
@validate
|
||||
box UserBox {
|
||||
@required @email
|
||||
name: StringBox # stored
|
||||
|
||||
@range(0,150)
|
||||
age: IntegerBox = 0 # stored + 初期値
|
||||
|
||||
email: StringBox { ... } # computed（読み専）
|
||||
|
||||
@env("TOKEN") @default("fallback")
|
||||
once token: StringBox => readEnv("TOKEN") # once
|
||||
}
|
||||
```
|
||||
|
||||
### マクロ適用ポイント
|
||||
- **@derive**（Boxに付く）：メソッド群を追加生成
|
||||
- **@validate**（Fieldに付く）：setter/loader注入
|
||||
- **@env/@default**：`load()`等のローダを注入
|
||||
|
||||
## 📋 具体的展開イメージ
|
||||
|
||||
### 1. @derive(Equals, ToString)
|
||||
**入力**:
|
||||
```nyash
|
||||
@derive(Equals, ToString)
|
||||
box UserBox { name: StringBox; age: IntegerBox = 0 }
|
||||
```
|
||||
|
||||
**展開結果**:
|
||||
```nyash
|
||||
method equals(other: UserBox) -> BoolBox {
|
||||
return me.name == other.name && me.age == other.age
|
||||
}
|
||||
method toString() -> StringBox {
|
||||
return "User(name=" + me.name + ", age=" + me.age + ")"
|
||||
}
|
||||
```
|
||||
|
||||
### 2. @validate（@range, @email, @required）
|
||||
**入力**:
|
||||
```nyash
|
||||
@validate
|
||||
box UserBox {
|
||||
@required @email
|
||||
email: StringBox
|
||||
|
||||
@range(0,150)
|
||||
age: IntegerBox = 0
|
||||
}
|
||||
```
|
||||
|
||||
**展開結果**:
|
||||
```nyash
|
||||
method set_email(v: StringBox) {
|
||||
if !v.contains("@") { throw new ValidationError("email") }
|
||||
me.email = v
|
||||
}
|
||||
method set_age(v: IntegerBox) {
|
||||
if v < 0 || v > 150 { throw new ValidationError("age") }
|
||||
me.age = v
|
||||
}
|
||||
```
|
||||
|
||||
### 3. @config_schema + @env + @default
|
||||
**入力**:
|
||||
```nyash
|
||||
@config_schema
|
||||
box AppConfig {
|
||||
@env("DATABASE_URL") @required
|
||||
database_url: StringBox
|
||||
|
||||
@env("DEBUG") @default(false) @parse_bool
|
||||
debug: BoolBox
|
||||
}
|
||||
```
|
||||
|
||||
**展開結果**:
|
||||
```nyash
|
||||
method load() -> Result<AppConfig, ErrorBox> {
|
||||
let cfg = new AppConfig()
|
||||
cfg.set_database_url(EnvBox.get("DATABASE_URL")?)
|
||||
cfg.set_debug(parseBool(EnvBox.getOr("DEBUG","false")))
|
||||
return Ok(cfg)
|
||||
}
|
||||
```
|
||||
|
||||
## 🔧 最小テストケース（品質保証）
|
||||
|
||||
ChatGPT推奨の4つの必須テスト：
|
||||
|
||||
1. **derive等価性**: `UserBox("a",1) == UserBox("a",1)` は真、`("a",2)`は偽
|
||||
2. **validate**: `age=200` で `ValidationError`／`email="x@y"`はOK
|
||||
3. **config**: `DATABASE_URL` 無設定で `Err`／設定済みで `Ok(AppConfig)`
|
||||
4. **macro hygiene**: `equals`を手書きしても生成と衝突しない（`gensym`で別名に）
|
||||
|
||||
## ✨ 追加マクロ案（戦略的拡張）
|
||||
|
||||
低コスト順の追加提案：
|
||||
|
||||
- **@test/@bench**: テスト関数自動収集、`nyash test`で実行（言語の信頼度UP）
|
||||
- **@log(entry|exit)**: メソッドへ軽量トレース注入（AOPの入口）
|
||||
- **@using(resource)**: RAII/スコープ終了処理の糖衣（`cleanup`モデルに合う）
|
||||
- **@derive(Builder)**: 引数多いBoxの生成補助（DX爆上がり）
|
||||
- **@serde(Json)**: `toJson/fromJson`の自動実装（`@derive(Json)`に統合可）
|
||||
- **@state_machine**: 状態遷移表→メソッド群と型安全イベント生成
|
||||
|
||||
## 🗺️ 実装ロードマップ（2スプリント）
|
||||
|
||||
### Sprint 1（エンジン + 即効3種）- 3週間
|
||||
- ✅ HIRパッチ式マクロエンジン（属性マクロのみ、ネット禁止）
|
||||
- ✅ `@derive(Equals, ToString, Clone)`
|
||||
- ✅ `@validate`（`@required, @range, @email, @min_length`）
|
||||
- ✅ `@config_schema / @env / @default / @parse_bool`
|
||||
- ✅ `nyash --expand` / `NYASH_MACRO_TRACE=1`
|
||||
|
||||
### Sprint 2（実用拡張）- 2-3週間
|
||||
- ✅ `@derive(Json)`（serde）
|
||||
- ✅ `@test` ランナー
|
||||
- ✅ `@api_client` の Phase 1（オフラインスキーマ）
|
||||
- ✅ `@sql_schema` の PoC（型付きクエリを1テーブル限定で）
|
||||
|
||||
## 🎯 ChatGPT最終推奨
|
||||
|
||||
> 必要なら、**@derive** と **@config_schema** の最小実装（パーサ差分・HIRパッチ・生成コード雛形）をすぐ書いて渡すよ。どれから着工いく？
|
||||
|
||||
### 推奨着工順序
|
||||
1. **@derive(Equals)** - 最小だが完整なMVP
|
||||
2. **HIRパッチエンジン基盤** - 拡張可能なアーキテクチャ
|
||||
3. **@validate統合** - 実用性の証明
|
||||
4. **@config_schema統合** - 実アプリケーション適用
|
||||
|
||||
## 📊 成功指標
|
||||
|
||||
### Sprint 1完了時
|
||||
- ✅ マクロ展開が正常動作（4つの最小テスト通過）
|
||||
- ✅ `nyash --expand`でデバッグ可能
|
||||
- ✅ 既存MIR14バックエンドで実行可能
|
||||
|
||||
### Sprint 2完了時
|
||||
- ✅ 実用アプリでマクロ活用例動作
|
||||
- ✅ JSON serde完全動作
|
||||
- ✅ テストランナー統合
|
||||
|
||||
---
|
||||
|
||||
**結論**: ChatGPTの最強思考モードにより、Nyash Macro Revolutionは**技術的実現可能性**と**段階的価値提供**の両方を満たす完璧な実装戦略が確定した。
|
||||
|
||||
*「どれもNyashにドンピシャ」- この一言が全てを物語る。*
|
||||
@ -0,0 +1,206 @@
|
||||
# Codex相談結果 - Macro System実装戦略と技術制約
|
||||
|
||||
**日時**: 2025-09-18
|
||||
**相談内容**: Box-Based Macro Systemの技術的実現可能性と実装ロードマップ
|
||||
|
||||
## 🎯 技術的結論（要約）
|
||||
|
||||
- ✅ **Property（実行時）+ Macro（コンパイル時）の厳密分離可能**
|
||||
- ✅ **既存MIR14命令で対応、新命令不要**
|
||||
- ✅ **Pattern Matching基盤 → Macro実装の順序妥当**
|
||||
- 📊 **工数見積もり**: 最小2-3週間、充実4-6週間
|
||||
|
||||
## 🔧 技術的課題への回答
|
||||
|
||||
### 1. Property System（実行時）+ Macro（コンパイル時）の実装分離は可能？
|
||||
|
||||
**Codex回答**: **可能だよ。**
|
||||
|
||||
#### 分離設計
|
||||
- **マクロ**: AST→ASTの純関数として実行（副作用なし、決定的）
|
||||
- **Property評価・状態**: 実行時のみ
|
||||
- **制約**: マクロが参照できるのはAST上の属性メタデータのみ
|
||||
|
||||
#### アーキテクチャ利点
|
||||
- **フロントエンド（マクロ/構文糖）とバックエンド（MIR/LLVM/Cranelift）が綺麗に分離**
|
||||
- **既存の実行パスに影響なし**
|
||||
|
||||
### 2. 既存MIR命令でマクロ展開をどう表現？新命令必要？
|
||||
|
||||
**Codex回答**: **原則不要だよ。**
|
||||
|
||||
#### 設計原則
|
||||
- **展開結果は通常の構文へ還元**
|
||||
- **既存のloweringでMIR14生成**
|
||||
- **追加要素**: デバッグ情報/起源（Span/Origin）のメタデータのみ
|
||||
|
||||
#### 命令セット維持の利点
|
||||
- 既存バックエンド（PyVM/LLVM/Cranelift）無変更
|
||||
- テスト・検証の継続性確保
|
||||
|
||||
### 3. Pattern Matching実装 → AST操作ツール → Macro Systemの技術的順序は妥当？
|
||||
|
||||
**Codex回答**: **妥当だよ。**
|
||||
|
||||
#### 推奨実装順序
|
||||
```
|
||||
AST utils（パターン/クオジクオート/リライト）
|
||||
↓
|
||||
マクロ（関数風、次に属性）
|
||||
↓
|
||||
余裕があれば言語のmatch/desugarを同じ基盤で実装
|
||||
```
|
||||
|
||||
#### Pattern Matching優先の技術的理由
|
||||
- **ASTは複雑なツリー構造** → Pattern Matchingが最適なツール
|
||||
- **マクロシステム自体の実装がクリーンになる**
|
||||
- **膨大なif let、switch、visitorパターンの回避**
|
||||
|
||||
### 4. MacroBox<InputAst, OutputAst>型安全マクロの実装コスト？
|
||||
|
||||
**Codex回答**: **段階導入を推奨。**
|
||||
|
||||
#### 実装戦略
|
||||
```
|
||||
Stage 1: 組み込み手続きマクロ（in-proc、型は動的検証）
|
||||
↓
|
||||
Stage 2: Rust内製MacroBox（型付きAPI）
|
||||
↓
|
||||
Stage 3: Hygiene/解決文脈まで型モデリング拡張
|
||||
```
|
||||
|
||||
#### コスト分析
|
||||
- **Rust実装**: Traitベースで比較的低リスク
|
||||
- **外部マクロ**: JSON AST + スキーマ検証で橋渡し
|
||||
- **初期**: 境界での厳格スキーマ検証を重視
|
||||
|
||||
### 5. 工数見積もりの現実性
|
||||
|
||||
**Codex回答**: **現実的工数を提示**
|
||||
|
||||
#### 詳細見積もり
|
||||
- **最小ASTパターン/クオジクオート/リライト**: 2-4日（1-2日は攻めすぎ）
|
||||
- **マクロシステム最小**: 2-3週間（関数風 + 簡易衛生 + エラーハンドリング）
|
||||
- **属性マクロ・派生・MacroBox（型付き）**: +2-3週間
|
||||
- **合計**: 4-6週間が妥当
|
||||
|
||||
## 🏗️ アーキテクチャ設計（Box-Based Macroの実像）
|
||||
|
||||
### マクロ実行境界
|
||||
```
|
||||
Parser → 解決前/中のフェーズでマクロ実行
|
||||
|
||||
実行順序:
|
||||
モジュール/マクロ定義収集
|
||||
→ マクロ解決
|
||||
→ 展開
|
||||
→ 構文糖デシュガ
|
||||
→ 型検査
|
||||
→ MIR lowering
|
||||
```
|
||||
|
||||
### API設計（Rust側）
|
||||
```rust
|
||||
trait Macro {
|
||||
fn expand(&self, ctx: &mut MacroCtx, input: AstNode) -> Result<AstNode>;
|
||||
}
|
||||
|
||||
// MacroCtx提供機能:
|
||||
// - fresh_symbol(), resolve_path()
|
||||
// - emit_error()/warn(), span合成
|
||||
// - 再帰カウンタ、featureフラグ
|
||||
```
|
||||
|
||||
### AST操作ツール
|
||||
- **パターン**: 変数束縛、ワイルドカード、可変長（…）
|
||||
- **準引用/脱引用**: ASTをコード片として安全に構築
|
||||
- **リライト**: 訪問/置換の汎用器（Span伝播対応）
|
||||
|
||||
### 衛生（Hygiene）設計
|
||||
```
|
||||
Stage 1: gensymベースの簡易衛生（捕捉回避）
|
||||
Stage 2: SyntaxContext/Scope Markによる本格衛生
|
||||
```
|
||||
|
||||
## 📋 実装フェーズとタスク
|
||||
|
||||
### Phase A（基盤・1週）
|
||||
- ✅ AST Pattern/Unifier（変数/ワイルドカード/variadic）
|
||||
- ✅ Quasi-quote/unquote、AST Builder、Span連鎖
|
||||
- ✅ Rewriter（停止条件/置換/環境）
|
||||
|
||||
### Phase B（最小マクロ・1-2週）
|
||||
- ✅ マクロ定義/登録/解決（関数風）
|
||||
- ✅ 簡易衛生（gensym）+ 再帰上限
|
||||
- ✅ エラー設計（Span指向、補助メッセージ）
|
||||
- ✅ 展開トレース `NYASH_MACRO_TRACE=1`
|
||||
|
||||
### Phase C（拡張・1-2週）
|
||||
- ✅ 属性マクロ（宣言/プロパティ/関数）
|
||||
- ✅ MacroBox（Rust in-proc型付きAPI）
|
||||
- ✅ デシュガ（pattern matching構文等）を基盤上で実装
|
||||
|
||||
### Phase D（高機能・以降）
|
||||
- ✅ 本格衛生（SyntaxContext）
|
||||
- ✅ 外部手続きマクロ（AST JSON v0）試験的
|
||||
- ✅ キャッシュ/インクリメンタル展開
|
||||
|
||||
## ✅ 受け入れ基準（各段階）
|
||||
|
||||
### Phase A完了基準
|
||||
- AST Pattern/クオジクオートのユニットテスト
|
||||
- Span一貫性の確保
|
||||
|
||||
### Phase B完了基準
|
||||
- マクロ→通常構文→MIR14が既存スモークと一致
|
||||
- PyVM/LLVM両方で差分なし
|
||||
|
||||
### Phase C完了基準
|
||||
- 属性マクロでProperty宣言の糖衣実装
|
||||
- MacroBoxで実例1つ動作
|
||||
|
||||
### Phase D完了基準
|
||||
- 再帰/衛生の難ケース（名前捕捉/別スコープ）で期待通り動作
|
||||
|
||||
## 🎯 制約とリスク対応
|
||||
|
||||
### Phase-15方針との整合
|
||||
- **優先度**: AST操作基盤 → 最小マクロ（in-proc）→ デシュガ → 属性マクロ
|
||||
- **制約**: Rust VM/JIT拡張は最小化、フロントエンド完結
|
||||
- **影響**: 既存実行経路への影響なし
|
||||
|
||||
### リスク対応策
|
||||
- **衛生の落とし穴**: 段階導入（gensym→context）で抑制
|
||||
- **エラーレポート品質**: Span合成と補助ヒント初期設計
|
||||
- **外部マクロ不安定化**: Phase-15中はin-proc限定
|
||||
- **無限展開**: 再帰上限と循環検出（展開履歴）
|
||||
|
||||
## 🚀 次アクション（Codex推奨）
|
||||
|
||||
### 即座に着手すべき
|
||||
1. **AST utils（Pattern/Quote/Rewrite）の最小設計確定**
|
||||
2. **MacroCtx/Registryの最小Trait草案作成**
|
||||
3. **関数風マクロ + 簡易衛生 + トレースでスモーク1本**
|
||||
4. **属性マクロでProperty糖衣（例: #[once]）実装**
|
||||
|
||||
### 実装方針
|
||||
> この方針なら、Property実行系に手を入れず、安全にマクロを導入できるよ。必要ならMacroCtx/Registryの最小APIスケッチもすぐ出すよ。
|
||||
|
||||
## 📊 工数見積もり詳細
|
||||
|
||||
| フェーズ | 内容 | 期間 | 累積 |
|
||||
|----------|------|------|------|
|
||||
| Phase A | AST基盤 | 3-5日 | 1週間 |
|
||||
| Phase B | 最小マクロ | 7-10日 | 2-3週間 |
|
||||
| Phase C | Box化・属性 | 7-10日 | 4-6週間 |
|
||||
| Phase D | 高機能化 | 1-2週間 | 6-8週間 |
|
||||
|
||||
### 最小ルート（急ぎ）
|
||||
- **最小を急げば**: 2-3週間
|
||||
- **充実まで**: 4-6週間
|
||||
|
||||
---
|
||||
|
||||
**結論**: Codexの技術分析により、**Box-Based Macro System**は既存アーキテクチャを壊すことなく、段階的に実装可能であることが確認された。
|
||||
|
||||
*技術的制約とリスクを明確化し、現実的な実装ロードマップを提示。*
|
||||
@ -0,0 +1,107 @@
|
||||
# Gemini相談結果 - Property System × Macro System統合の哲学的検討
|
||||
|
||||
**日時**: 2025-09-18
|
||||
**相談内容**: Property System（リアルタイム計算）とMacro System（コンパイル時生成）の統合合理性
|
||||
|
||||
## 🎯 核心的質問と回答
|
||||
|
||||
### 質問1: Property SystemとMacro Systemの統合は合理的か？
|
||||
|
||||
**Gemini回答**: **合理的ですが、両者の役割分担と境界を明確に定義することが極めて重要です。**
|
||||
|
||||
#### 時間軸の違いが強みになる
|
||||
- **Macro System**: コンパイル時にコード（AST）を生成・変換
|
||||
- **Property System**: 実行時にデータへのアクセス方法を定義
|
||||
|
||||
#### シナジー（相乗効果）
|
||||
1. **マクロによるプロパティの自動生成**: 定型的なプロパティを自動実装
|
||||
2. **コンパイル時情報へのアクセス**: 型情報・アノテーション読み取り→最適プロパティ生成
|
||||
|
||||
#### 設計上の注意点
|
||||
- **明確な境界**: ユーザーが実行タイミングを直感的に理解できる設計
|
||||
- **哲学的一貫性**: 「Everything is Box」下での`MacroBox`→`PropertyBox`生成関係
|
||||
|
||||
### 質問2: MacroBoxによる一等市民マクロは革新的か、それとも複雑化か？
|
||||
|
||||
**Gemini回答**: **極めて革新的ですが、それに伴う複雑性を乗り越えるための強力な「ガードレール」が必要です。**
|
||||
|
||||
#### 革新的な点
|
||||
1. **構成可能性（Composability）**: マクロを生成する関数、マクロを引数に取る高階マクロ
|
||||
2. **型付けされたマクロ**: `MacroBox<InputAst, OutputAst>`で型安全性確保
|
||||
3. **哲学的な完成度**: 「Everything is Box」世界での最後の重要ピース
|
||||
|
||||
#### 複雑化への対策
|
||||
1. **デバッグの困難さ対策**:
|
||||
- マクロ展開の各ステップ視覚化ツール
|
||||
- 生成コードの人間可読出力（`cargo expand`相当）
|
||||
- コンパイル時コード専用デバッガー
|
||||
|
||||
2. **認知負荷対策**:
|
||||
- シンプルなユースケースではマクロを意識させない設計
|
||||
- 高度ユーザー向け明確ドキュメント・チュートリアル
|
||||
|
||||
### 質問3: 実装優先度 - Pattern Matching vs Macro System
|
||||
|
||||
**Gemini回答**: **Pattern Matchingを優先すべきです。**
|
||||
|
||||
#### 優先理由
|
||||
1. **基礎となる機能**: 代数的データ型を扱う根源的機能
|
||||
2. **マクロ実装のツールになる**: ASTは複雑なツリー構造→Pattern Matchingが最高のツール
|
||||
3. **段階的な成功**: 単体で価値の明確な機能
|
||||
|
||||
#### 戦略的ロードマップ
|
||||
```
|
||||
Pattern Matching実装 → 言語の土台固め → マクロシステム実装
|
||||
```
|
||||
|
||||
**マクロシステム自体の実装が、Pattern Matchingなしだとバグの温床になる危険性**
|
||||
|
||||
## 💡 重要な洞察
|
||||
|
||||
### MacroBox<InputAst, OutputAst>の型安全性
|
||||
```nyash
|
||||
// 革命的な型付きマクロ
|
||||
box DeriveMacroBox<StructAst, MethodsAst> {
|
||||
expand(input: StructAst) -> MethodsAst {
|
||||
// 型安全なAST変換
|
||||
// Lispの弱点（型安全性欠如）を克服
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Everything is Box哲学の完成
|
||||
> 「Everything is Box」の世界では、コード変換ロジックですら`Box`に収められ、値として扱えるべきです。`MacroBox`は、この哲学を完成させるための最後の、そして最も重要なピースかもしれません。
|
||||
|
||||
### Pattern Matchingの戦略的価値
|
||||
> Pattern Matchingは、代数的データ型（`enum`など）を扱うための根源的な機能です。これにより、条件分岐やデータ分解のロジックが劇的にクリーンで安全になります。
|
||||
|
||||
## 🎯 Geminiの最終推奨
|
||||
|
||||
### 実装順序
|
||||
1. **Pattern Matching**: 言語のデータ操作能力という土台を固める
|
||||
2. **Box-Based Macro System**: Pattern Matchingを武器として革新的システム実装
|
||||
|
||||
### 成功への道筋
|
||||
> まず**Pattern Matching**を実装して言語のデータ操作能力という土台を固めます。次に、その強力なPattern Matchingを武器として、革新的だが複雑な**Box-Based Macro System**の設計と実装に着手する。この順番が、言語の健全な発展と、最終的な「世界最強のマクロ言語」という目標達成への最も確実な道筋だと考えます。
|
||||
|
||||
## 🌟 哲学的評価
|
||||
|
||||
### 言語設計の観点から
|
||||
- ✅ **概念的一貫性**: Property × Macro統合は理論的に美しい
|
||||
- ✅ **革新性**: MacroBox一等市民化は前例のない試み
|
||||
- ✅ **実用性**: 段階的実装により現実的な価値提供可能
|
||||
|
||||
### リスク管理の観点から
|
||||
- ⚠️ **複雑性制御**: ガードレール設計が成功の鍵
|
||||
- ⚠️ **学習コスト**: 教育的価値とのバランス重要
|
||||
- ⚠️ **デバッグ性**: 開発体験の維持が必須
|
||||
|
||||
## 📋 今後への期待
|
||||
|
||||
> Nyash言語の「Everything is Box」という哲学は、これらの先進的な機能を探求する上で非常に強力な基盤となります。今後の発展を心から楽しみにしています。
|
||||
|
||||
---
|
||||
|
||||
**結論**: Geminiの哲学的検討により、**Property System × Macro System統合**の理論的合理性と、**Pattern Matching優先実装**の戦略的妥当性が確認された。
|
||||
|
||||
*言語設計の観点から、Nyashの革新的アプローチは「極めて野心的かつ実現可能」と評価。*
|
||||
@ -0,0 +1,318 @@
|
||||
# Phase 16 実装ロードマップ - Macro Revolution統合戦略
|
||||
|
||||
**策定日**: 2025-09-18
|
||||
**ステータス**: 実装準備完了
|
||||
**総工数見積もり**: 4-6週間（ChatGPT・Codex・Gemini合意）
|
||||
|
||||
## 🎯 統合戦略の核心
|
||||
|
||||
### AI三賢者の合意事項
|
||||
- **ChatGPT**: "@derive(Equals)から始めて段階的価値提供"
|
||||
- **Gemini**: "Pattern Matching → Macro Systemの順序が最適"
|
||||
- **Codex**: "HIRパッチ式で既存MIR14命令無変更が可能"
|
||||
|
||||
### 技術的確定事項
|
||||
- ✅ **Property（実行時）+ Macro（コンパイル時）の厳密分離**
|
||||
- ✅ **HIRパッチ式マクロエンジン**でMIR14命令不変
|
||||
- ✅ **MacroBox<InputAst, OutputAst>**型安全設計
|
||||
- ✅ **最小4つのテストケース**で品質保証
|
||||
|
||||
## 🚀 Phase 16.1: Pattern Matching基盤（優先実装）
|
||||
|
||||
### 期間: 2週間
|
||||
### 理由: Gemini「マクロ実装のツールになる」
|
||||
|
||||
#### 実装内容
|
||||
```nyash
|
||||
// 基本パターンマッチング
|
||||
local result = match value {
|
||||
0 => "zero",
|
||||
1..10 => "small",
|
||||
_ => "other"
|
||||
}
|
||||
|
||||
// Box destructuring
|
||||
match user_box {
|
||||
UserBox(name, age) => process(name, age),
|
||||
_ => error("invalid box")
|
||||
}
|
||||
```
|
||||
|
||||
#### 完了条件
|
||||
- [ ] AST Pattern/Unifier実装
|
||||
- [ ] 基本match式の動作確認
|
||||
- [ ] Box destructuringの実装
|
||||
- [ ] MIR lowering完了
|
||||
|
||||
## 🛠️ Phase 16.2: AST操作基盤（1週間）
|
||||
|
||||
### Codex推奨の技術基盤
|
||||
|
||||
#### 実装内容
|
||||
- **AST Pattern**: 変数束縛、ワイルドカード、可変長（…）
|
||||
- **準引用/脱引用**: ASTをコード片として安全に構築
|
||||
- **リライト機能**: 訪問/置換の汎用器（Span伝播対応）
|
||||
|
||||
#### API設計
|
||||
```rust
|
||||
// Rust側の基盤API
|
||||
trait MacroPattern {
|
||||
fn match_ast(&self, node: &AstNode) -> Option<HashMap<String, AstNode>>;
|
||||
}
|
||||
|
||||
trait AstBuilder {
|
||||
fn quote(&self, code: &str) -> AstNode;
|
||||
fn unquote(&self, template: &AstNode, bindings: &HashMap<String, AstNode>) -> AstNode;
|
||||
}
|
||||
```
|
||||
|
||||
#### 完了条件
|
||||
- [ ] Pattern matching for AST
|
||||
- [ ] Quote/unquote mechanism
|
||||
- [ ] AST rewriter with Span preservation
|
||||
- [ ] Unit tests for all components
|
||||
|
||||
## 🎯 Phase 16.3: 最小マクロMVP（2週間）
|
||||
|
||||
### ChatGPT最優先: @derive(Equals)
|
||||
|
||||
#### 実装目標
|
||||
```nyash
|
||||
// 入力
|
||||
@derive(Equals, ToString)
|
||||
box UserBox {
|
||||
name: StringBox
|
||||
age: IntegerBox
|
||||
}
|
||||
|
||||
// 自動生成（HIRパッチとして注入）
|
||||
method equals(other: UserBox) -> BoolBox {
|
||||
return me.name == other.name && me.age == other.age
|
||||
}
|
||||
|
||||
method toString() -> StringBox {
|
||||
return "UserBox(name=" + me.name + ", age=" + me.age + ")"
|
||||
}
|
||||
```
|
||||
|
||||
#### 技術アーキテクチャ
|
||||
```
|
||||
Parse → HIR → (Macro Expansion) → TypeCheck → MIR14 → Backends
|
||||
```
|
||||
|
||||
#### HIRパッチ式設計
|
||||
- **マクロはHIR上の「差分パッチ」として実行**
|
||||
- **生成物は普通のBox/メソッド定義**
|
||||
- **MIRには一切新命令を足さない**
|
||||
|
||||
#### Hygiene（衛生）設計
|
||||
```nyash
|
||||
// gensymによる名前衝突回避
|
||||
method __generated_equals_1234(other: UserBox) -> BoolBox {
|
||||
// 生成されたメソッド
|
||||
}
|
||||
```
|
||||
|
||||
#### 完了条件
|
||||
- [ ] @derive(Equals)の動作確認
|
||||
- [ ] @derive(ToString)の動作確認
|
||||
- [ ] HIRパッチエンジンの安定動作
|
||||
- [ ] 4つの必須テストケース通過
|
||||
|
||||
## 🛡️ Phase 16.4: @validate統合（1週間）
|
||||
|
||||
### ChatGPT第2優先: 型安全・入力品質
|
||||
|
||||
#### 実装目標
|
||||
```nyash
|
||||
@validate
|
||||
box UserBox {
|
||||
@required @email
|
||||
email: StringBox
|
||||
|
||||
@range(0, 150)
|
||||
age: IntegerBox
|
||||
}
|
||||
```
|
||||
|
||||
#### 自動生成
|
||||
```nyash
|
||||
method set_email(value: StringBox) {
|
||||
if value.length() == 0 {
|
||||
throw new ValidationError("email is required")
|
||||
}
|
||||
if !value.contains("@") {
|
||||
throw new ValidationError("invalid email format")
|
||||
}
|
||||
me.email = value
|
||||
}
|
||||
```
|
||||
|
||||
#### 完了条件
|
||||
- [ ] @required, @email, @range実装
|
||||
- [ ] ValidationError統合
|
||||
- [ ] setter methods自動生成
|
||||
- [ ] Property System統合
|
||||
|
||||
## ⚙️ Phase 16.5: @config_schema統合（1週間）
|
||||
|
||||
### ChatGPT第3優先: 実アプリ即効
|
||||
|
||||
#### 実装目標
|
||||
```nyash
|
||||
@config_schema
|
||||
box AppConfig {
|
||||
@env("DATABASE_URL") @required
|
||||
database_url: StringBox
|
||||
|
||||
@env("DEBUG") @default(false) @parse_bool
|
||||
debug: BoolBox
|
||||
}
|
||||
```
|
||||
|
||||
#### 自動生成
|
||||
```nyash
|
||||
static method load() -> Result<AppConfig, ConfigError> {
|
||||
// 環境変数ベース設定ローダー
|
||||
}
|
||||
```
|
||||
|
||||
#### 完了条件
|
||||
- [ ] @env, @default, @required統合
|
||||
- [ ] 環境変数読み込み
|
||||
- [ ] 型変換（@parse_bool等）
|
||||
- [ ] Result型での安全な設定読み込み
|
||||
|
||||
## 🎉 Phase 16.6: 統合テスト・デモ（1週間）
|
||||
|
||||
### 品質保証とデモンストレーション
|
||||
|
||||
#### ChatGPT推奨の必須テスト
|
||||
1. **derive等価性**: `UserBox("a",1) == UserBox("a",1)` → 真
|
||||
2. **validation**: `age=200` → `ValidationError`
|
||||
3. **config**: `DATABASE_URL`未設定 → `Err`
|
||||
4. **hygiene**: 手書き`equals`と生成コードが衝突しない
|
||||
|
||||
#### デバッグツール
|
||||
- `nyash --expand`: マクロ展開結果の可視化
|
||||
- `NYASH_MACRO_TRACE=1`: ステップバイステップ追跡
|
||||
|
||||
#### 完了条件
|
||||
- [ ] 全テストケース通過
|
||||
- [ ] 実用アプリでの動作確認
|
||||
- [ ] パフォーマンス測定
|
||||
- [ ] ドキュメント完成
|
||||
|
||||
## 🌟 Phase 16.7: 即効追加マクロ（1週間）
|
||||
|
||||
### ChatGPT推奨の低コスト・高価値マクロ
|
||||
|
||||
#### @test/@bench（最優先実装）
|
||||
```nyash
|
||||
@test
|
||||
method test_user_creation() {
|
||||
local user = new UserBox("Alice", 25)
|
||||
assert user.name == "Alice"
|
||||
}
|
||||
|
||||
@bench
|
||||
method bench_sorting() {
|
||||
// ベンチマーク処理
|
||||
}
|
||||
```
|
||||
- **実装コスト**: 超低（関数収集+ランナーのみ）
|
||||
- **価値**: 言語信頼性の即座向上
|
||||
- **実行**: `nyash test`, `nyash bench`
|
||||
|
||||
#### @serde(Json)
|
||||
```nyash
|
||||
@serde(Json)
|
||||
box ApiResponseBox {
|
||||
status: IntegerBox
|
||||
data: UserBox
|
||||
}
|
||||
```
|
||||
- **実装コスト**: 超低（@derive(Json)拡張）
|
||||
- **価値**: Web開発必須機能
|
||||
|
||||
## 🚀 Phase 16.8: DX革命マクロ（1-2週間）
|
||||
|
||||
#### @derive(Builder)（Nyash独自の魅力）
|
||||
```nyash
|
||||
@derive(Builder)
|
||||
box HttpRequestBox {
|
||||
url: StringBox
|
||||
method: StringBox
|
||||
headers: MapBox
|
||||
}
|
||||
|
||||
// 美しいFluent API生成
|
||||
local request = HttpRequestBox.builder()
|
||||
.url("https://api.example.com")
|
||||
.method("POST")
|
||||
.build()
|
||||
```
|
||||
|
||||
## 🔧 Phase 16.9以降: 高度マクロ
|
||||
|
||||
#### Phase 16.9: @using(resource)（2-3週間）
|
||||
- **RAII/cleanup統合**: リソース安全管理
|
||||
- **実装コスト**: 高（スコープ管理複雑）
|
||||
|
||||
#### Phase 16.10: その他高度機能
|
||||
- **@log(entry|exit)**: AOP基盤
|
||||
- **@api_client**: OpenAPI統合
|
||||
- **@sql_schema**: 型安全SQL
|
||||
- **@state_machine**: 究極の差別化
|
||||
|
||||
## 📊 成功指標とマイルストーン
|
||||
|
||||
### Phase 16.3完了時（MVP達成）
|
||||
- ✅ @derive(Equals, ToString)動作
|
||||
- ✅ HIRパッチエンジン安定
|
||||
- ✅ 既存MIR14バックエンドで実行可能
|
||||
- ✅ `nyash --expand`でデバッグ可能
|
||||
|
||||
### Phase 16.6完了時（実用達成）
|
||||
- ✅ @derive/@validate/@config_schema完全動作
|
||||
- ✅ 実用アプリでの活用例動作
|
||||
- ✅ 4つの必須テスト完全通過
|
||||
- ✅ Property System完全統合
|
||||
|
||||
### Phase 16.7完了時（世界最強達成）
|
||||
- ✅ JSON serde完全動作
|
||||
- ✅ テストランナー統合
|
||||
- ✅ API生成・SQL型安全の実証
|
||||
- ✅ 他言語を超越する表現力実現
|
||||
|
||||
## ⚠️ リスク対応策
|
||||
|
||||
### 技術的リスク
|
||||
- **無限展開**: 再帰上限と循環検出
|
||||
- **デバッグ困難**: 展開トレースと可視化ツール
|
||||
- **パフォーマンス**: HIRパッチの最適化
|
||||
|
||||
### プロジェクトリスク
|
||||
- **複雑化**: 段階的導入で制御
|
||||
- **学習コスト**: 充実したドキュメントとサンプル
|
||||
- **既存影響**: MIR14不変でリスク最小化
|
||||
|
||||
## 🎯 次のアクション
|
||||
|
||||
### 即座着手（今週）
|
||||
1. **Pattern Matching最小実装**開始
|
||||
2. **AST操作基盤API設計**確定
|
||||
3. **HIRパッチエンジン設計**詳細化
|
||||
4. **@derive(Equals)実装計画**策定
|
||||
|
||||
### 2週間後
|
||||
1. **Pattern Matching完成**
|
||||
2. **@derive(Equals)スモーク動作**
|
||||
3. **マクロ展開デバッグツール**完成
|
||||
4. **実用アプリ適用**開始
|
||||
|
||||
---
|
||||
|
||||
**Phase 16 Macro Revolution**により、Nyashは世界最強のマクロ言語への道を確実に歩む。
|
||||
|
||||
*全AI賢者の叡智を統合した、実現可能かつ革新的な実装戦略。*
|
||||
@ -0,0 +1,219 @@
|
||||
# Phase 16 次期実装タスク - 実装開始への具体的ステップ
|
||||
|
||||
**策定日**: 2025-09-18
|
||||
**ステータス**: 実装準備完了
|
||||
**優先度**: 最高（全AI相談結果に基づく統合計画）
|
||||
|
||||
## 🎯 実装開始の準備状況
|
||||
|
||||
### ✅ 完了済み（計画・設計フェーズ）
|
||||
- **AI三賢者相談完了**: ChatGPT・Gemini・Codex全ての技術検証済み
|
||||
- **統合実装ロードマップ**: 4-6週間の詳細計画策定済み
|
||||
- **Pattern Matching基盤計画**: 2週間の実装詳細完成
|
||||
- **マクロ実例集**: 6つの革命的マクロタイプの具体例完成
|
||||
- **技術アーキテクチャ**: HIRパッチ式エンジン設計確定
|
||||
|
||||
## 🚀 即座実装タスク（今週着手推奨）
|
||||
|
||||
### Task 1: Pattern Matching実装開始（最優先）
|
||||
**期間**: 2週間
|
||||
**理由**: Gemini・Codex共に「マクロ実装の必須基盤」と明言
|
||||
|
||||
#### Week 1: 基本構文
|
||||
```bash
|
||||
# 実装ファイル
|
||||
src/parser/pattern_matching.rs # パターン構文解析
|
||||
src/ast/pattern.rs # Pattern AST定義
|
||||
src/mir/lowering/pattern.rs # Pattern → MIR14変換
|
||||
```
|
||||
|
||||
#### Week 2: 高度機能
|
||||
```bash
|
||||
# 実装ファイル
|
||||
src/parser/destructuring.rs # Box destructuring
|
||||
src/type_checker/pattern.rs # パターン型検査
|
||||
src/mir/optimization/pattern.rs # パターン最適化
|
||||
```
|
||||
|
||||
#### 受け入れ基準
|
||||
```nyash
|
||||
// 動作必須テスト
|
||||
local result = match value {
|
||||
0 => "zero",
|
||||
1..10 => "small",
|
||||
UserBox(name, age) => "user: " + name,
|
||||
_ => "other"
|
||||
}
|
||||
```
|
||||
|
||||
### Task 2: AST操作基盤構築（Pattern Matching並行）
|
||||
**期間**: 1週間
|
||||
**依存**: Pattern Matching Week 1完了後
|
||||
|
||||
#### 実装内容
|
||||
```bash
|
||||
# 新規ファイル
|
||||
src/macro_system/ast_pattern.rs # AST用Pattern Matching
|
||||
src/macro_system/quote.rs # 準引用/脱引用
|
||||
src/macro_system/rewriter.rs # AST書き換え器
|
||||
```
|
||||
|
||||
#### API設計例
|
||||
```rust
|
||||
// マクロでのAST操作
|
||||
fn expand_derive(input: &AstNode) -> Result<AstNode> {
|
||||
match input {
|
||||
BoxDef { name, fields } => {
|
||||
let equals_method = quote! {
|
||||
method equals(other: #name) -> BoolBox {
|
||||
#(generate_field_comparisons(fields))
|
||||
}
|
||||
};
|
||||
Ok(equals_method)
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Task 3: @derive(Equals)最小実装（MVP）
|
||||
**期間**: 1週間
|
||||
**依存**: Task 1・2完了
|
||||
|
||||
#### 実装目標
|
||||
```nyash
|
||||
// 入力
|
||||
@derive(Equals)
|
||||
box UserBox {
|
||||
name: StringBox
|
||||
age: IntegerBox
|
||||
}
|
||||
|
||||
// 自動生成
|
||||
method equals(other: UserBox) -> BoolBox {
|
||||
return me.name == other.name && me.age == other.age
|
||||
}
|
||||
```
|
||||
|
||||
#### 実装ファイル
|
||||
```bash
|
||||
src/macro_system/derive/mod.rs # derive マクロシステム
|
||||
src/macro_system/derive/equals.rs # Equals実装ジェネレーター
|
||||
src/macro_system/registry.rs # マクロ登録システム
|
||||
```
|
||||
|
||||
## 📋 並行作業可能タスク
|
||||
|
||||
### A系列: コア機能実装
|
||||
- [ ] Pattern Matching parser
|
||||
- [ ] AST manipulation tools
|
||||
- [ ] HIR patch engine
|
||||
- [ ] @derive(Equals) generator
|
||||
|
||||
### B系列: 品質保証
|
||||
- [ ] Unit tests for pattern matching
|
||||
- [ ] Integration tests for macro expansion
|
||||
- [ ] Performance benchmarks
|
||||
- [ ] Error message quality
|
||||
|
||||
### C系列: 開発体験
|
||||
- [ ] `nyash --expand` コマンド
|
||||
- [ ] `NYASH_MACRO_TRACE=1` デバッグ
|
||||
- [ ] マクロ展開可視化ツール
|
||||
- [ ] 開発者ドキュメント
|
||||
|
||||
## 🎯 2週間後の目標状態
|
||||
|
||||
### 動作するコード例
|
||||
```nyash
|
||||
// Pattern Matching が動作
|
||||
local greeting = match user {
|
||||
UserBox(name, age) => "Hello " + name + "!",
|
||||
AdminBox(name) => "Hello Admin " + name + "!",
|
||||
_ => "Hello stranger!"
|
||||
}
|
||||
|
||||
// @derive(Equals) が動作
|
||||
@derive(Equals, ToString)
|
||||
box PersonBox {
|
||||
name: StringBox
|
||||
age: IntegerBox
|
||||
}
|
||||
|
||||
local person1 = new PersonBox("Alice", 25)
|
||||
local person2 = new PersonBox("Alice", 25)
|
||||
assert person1.equals(person2) // 自動生成されたequalsメソッド
|
||||
```
|
||||
|
||||
### 技術達成目標
|
||||
- ✅ Pattern Matching基本動作（リテラル・変数・構造パターン）
|
||||
- ✅ @derive(Equals)自動生成動作
|
||||
- ✅ HIRパッチエンジン基盤完成
|
||||
- ✅ マクロ展開デバッグツール動作
|
||||
|
||||
## 🔧 実装時の技術指針
|
||||
|
||||
### 安全な実装戦略
|
||||
1. **既存MIR14命令不変**: 新命令追加なし
|
||||
2. **段階的機能追加**: 最小動作から開始
|
||||
3. **回帰テスト重視**: 既存機能への影響なし
|
||||
4. **エラーハンドリング**: 明確なエラーメッセージ
|
||||
|
||||
### パフォーマンス考慮
|
||||
1. **Pattern最適化**: Jump table、Decision tree
|
||||
2. **マクロキャッシュ**: 展開結果のキャッシュ
|
||||
3. **漸進的コンパイル**: 変更部分のみ再処理
|
||||
4. **メモリ効率**: AST操作の最適化
|
||||
|
||||
## 🚨 実装時の注意点
|
||||
|
||||
### Hygiene（衛生）問題
|
||||
```nyash
|
||||
// 生成されるメソッド名が既存と衝突しないように
|
||||
method __generated_equals_#unique_id(other: UserBox) -> BoolBox {
|
||||
// 安全な名前空間での生成
|
||||
}
|
||||
```
|
||||
|
||||
### エラー報告品質
|
||||
```nyash
|
||||
// 良いエラーメッセージ例
|
||||
Error: @derive(Equals) cannot be applied to UserBox
|
||||
→ UserBox contains field 'callback' of type FunctionBox
|
||||
→ Equals comparison is not supported for FunctionBox
|
||||
Help: Consider implementing custom equals method or excluding this field
|
||||
```
|
||||
|
||||
### デバッグ支援
|
||||
```bash
|
||||
# マクロ展開の可視化
|
||||
nyash --expand program.nyash
|
||||
|
||||
# ステップバイステップ追跡
|
||||
NYASH_MACRO_TRACE=1 nyash program.nyash
|
||||
```
|
||||
|
||||
## 📊 成功指標（2週間後）
|
||||
|
||||
### 機能的成功
|
||||
- [ ] Pattern Matching基本テスト全通過
|
||||
- [ ] @derive(Equals)生成コード動作確認
|
||||
- [ ] 既存テストスイート全通過（回帰なし）
|
||||
- [ ] 実用サンプルアプリでの動作確認
|
||||
|
||||
### 技術的成功
|
||||
- [ ] MIR14出力の妥当性確認
|
||||
- [ ] PyVM・LLVMバックエンド両対応
|
||||
- [ ] パフォーマンス基準クリア
|
||||
- [ ] メモリ使用量の適正範囲
|
||||
|
||||
### 開発者体験
|
||||
- [ ] 明確なエラーメッセージ提供
|
||||
- [ ] デバッグツールの実用性確認
|
||||
- [ ] ドキュメントの完成度
|
||||
- [ ] サンプルコードの動作確認
|
||||
|
||||
---
|
||||
|
||||
**Phase 16実装開始！世界最強マクロ言語への第一歩。**
|
||||
|
||||
*「Pattern Matching → @derive(Equals) → 世界征服」- 明確な実装経路の確立完了。*
|
||||
@ -0,0 +1,341 @@
|
||||
# Pattern Matching基盤実装計画 - Macro Revolution前哨戦
|
||||
|
||||
**策定日**: 2025-09-18
|
||||
**優先度**: 最高（Gemini/Codex推奨）
|
||||
**期間見積もり**: 2週間
|
||||
**依存関係**: Phase 16マクロ実装の必須前提条件
|
||||
|
||||
## 🎯 なぜPattern Matchingが最優先なのか？
|
||||
|
||||
### Gemini の洞察
|
||||
> **Pattern Matchingは、代数的データ型を扱うための根源的な機能です。これにより、条件分岐やデータ分解のロジックが劇的にクリーンで安全になります。**
|
||||
|
||||
### Codex の技術的理由
|
||||
> **ASTは複雑なツリー構造** → **Pattern Matchingが最適なツール**
|
||||
> **マクロシステム自体の実装がクリーンになる**
|
||||
> **膨大なif let、switch、visitorパターンの回避**
|
||||
|
||||
### 戦略的重要性
|
||||
1. **基礎機能**: 言語のデータ操作能力という土台を固める
|
||||
2. **マクロ実装ツール**: ASTパターンマッチングで安全な操作が可能
|
||||
3. **段階的成功**: 単体でも価値の明確な機能
|
||||
4. **実装準備**: マクロシステムの基盤ツールとして機能
|
||||
|
||||
## 🏗️ 実装アーキテクチャ設計
|
||||
|
||||
### Pattern Matching構文設計
|
||||
```nyash
|
||||
// 基本的なmatch式
|
||||
local result = match value {
|
||||
0 => "zero",
|
||||
1 => "one",
|
||||
2..10 => "small",
|
||||
_ => "other"
|
||||
}
|
||||
|
||||
// Box destructuring（構造パターン）
|
||||
match user_box {
|
||||
UserBox(name, age) => {
|
||||
print("User: " + name + ", Age: " + age)
|
||||
},
|
||||
AdminBox(name, permissions) => {
|
||||
print("Admin: " + name)
|
||||
},
|
||||
_ => {
|
||||
print("Unknown box type")
|
||||
}
|
||||
}
|
||||
|
||||
// ガード付きパターン
|
||||
match request {
|
||||
HttpRequest(method, path) if method == "GET" => handle_get(path),
|
||||
HttpRequest(method, path) if method == "POST" => handle_post(path),
|
||||
HttpRequest(method, _) => error("Unsupported method: " + method)
|
||||
}
|
||||
|
||||
// ネストした構造パターン
|
||||
match response {
|
||||
Ok(UserBox(name, ProfileBox(email, age))) => {
|
||||
print("Success: " + name + " (" + email + ")")
|
||||
},
|
||||
Err(ErrorBox(code, message)) => {
|
||||
print("Error " + code + ": " + message)
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### AST表現設計
|
||||
```rust
|
||||
// Rust側での内部表現
|
||||
#[derive(Debug, Clone)]
|
||||
pub enum Pattern {
|
||||
// リテラルパターン
|
||||
Literal(LiteralValue),
|
||||
|
||||
// 変数バインディング
|
||||
Variable(String),
|
||||
|
||||
// ワイルドカード
|
||||
Wildcard,
|
||||
|
||||
// 範囲パターン
|
||||
Range { start: Box<Pattern>, end: Box<Pattern> },
|
||||
|
||||
// 構造パターン（Box destructuring）
|
||||
Struct {
|
||||
box_name: String,
|
||||
fields: Vec<Pattern>
|
||||
},
|
||||
|
||||
// OR パターン
|
||||
Or(Vec<Pattern>),
|
||||
|
||||
// ガード付きパターン
|
||||
Guard { pattern: Box<Pattern>, condition: Expr },
|
||||
}
|
||||
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct MatchArm {
|
||||
pub pattern: Pattern,
|
||||
pub guard: Option<Expr>,
|
||||
pub body: Expr,
|
||||
}
|
||||
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct MatchExpr {
|
||||
pub scrutinee: Expr, // マッチ対象
|
||||
pub arms: Vec<MatchArm>,
|
||||
}
|
||||
```
|
||||
|
||||
## 🔧 実装フェーズ
|
||||
|
||||
### Phase PM.1: 基本構文実装（1週間）
|
||||
|
||||
#### Day 1-2: パーサー拡張
|
||||
- [ ] `match` キーワードの追加
|
||||
- [ ] パターン構文の解析
|
||||
- [ ] `=>` 記号の処理
|
||||
- [ ] ガード条件（`if`）の解析
|
||||
|
||||
#### Day 3-4: AST構築
|
||||
- [ ] Pattern/MatchExpr AST nodes
|
||||
- [ ] パターンバインディングの処理
|
||||
- [ ] スコープ管理の実装
|
||||
- [ ] 型検査の基礎
|
||||
|
||||
#### Day 5-7: 基本動作確認
|
||||
- [ ] リテラルパターンのテスト
|
||||
- [ ] 変数バインディングのテスト
|
||||
- [ ] ワイルドカードのテスト
|
||||
- [ ] 基本的なmatch式の動作確認
|
||||
|
||||
### Phase PM.2: 高度パターン実装（1週間）
|
||||
|
||||
#### Day 8-10: 構造パターン
|
||||
- [ ] Box destructuring実装
|
||||
- [ ] ネストした構造の処理
|
||||
- [ ] フィールド名による分解
|
||||
- [ ] 型安全性の確保
|
||||
|
||||
#### Day 11-12: 範囲・ガード
|
||||
- [ ] 範囲パターン（`1..10`）
|
||||
- [ ] ガード条件（`if`）
|
||||
- [ ] 複雑な条件式の処理
|
||||
- [ ] パフォーマンス最適化
|
||||
|
||||
#### Day 13-14: 統合テスト
|
||||
- [ ] 複雑なパターンの組み合わせ
|
||||
- [ ] エラーハンドリング
|
||||
- [ ] 網羅性チェック（exhaustiveness）
|
||||
- [ ] コード生成の確認
|
||||
|
||||
## 🎯 MIR Lowering戦略
|
||||
|
||||
### Pattern Matching → MIR14変換
|
||||
|
||||
```nyash
|
||||
// 入力コード
|
||||
match value {
|
||||
0 => "zero",
|
||||
1..5 => "small",
|
||||
_ => "other"
|
||||
}
|
||||
```
|
||||
|
||||
```
|
||||
// 生成されるMIR14（概念的）
|
||||
%temp1 = compare %value, 0
|
||||
branch %temp1, @case_zero, @check_range
|
||||
|
||||
@check_range:
|
||||
%temp2 = compare %value, 1, gte
|
||||
%temp3 = compare %value, 5, lte
|
||||
%temp4 = binop %temp2, %temp3, and
|
||||
branch %temp4, @case_small, @case_default
|
||||
|
||||
@case_zero:
|
||||
%result = const "zero"
|
||||
jump @match_end
|
||||
|
||||
@case_small:
|
||||
%result = const "small"
|
||||
jump @match_end
|
||||
|
||||
@case_default:
|
||||
%result = const "other"
|
||||
jump @match_end
|
||||
|
||||
@match_end:
|
||||
// %result contains the final value
|
||||
```
|
||||
|
||||
### 最適化戦略
|
||||
- **Jump table**: 整数パターンの最適化
|
||||
- **Decision tree**: 複雑なパターンの効率的分岐
|
||||
- **Exhaustiveness**: コンパイル時の網羅性チェック
|
||||
|
||||
## 🧪 テスト戦略
|
||||
|
||||
### 最小テストケース
|
||||
```nyash
|
||||
// Test 1: 基本パターン
|
||||
local result1 = match 42 {
|
||||
0 => "zero",
|
||||
42 => "answer",
|
||||
_ => "other"
|
||||
}
|
||||
assert result1 == "answer"
|
||||
|
||||
// Test 2: 範囲パターン
|
||||
local result2 = match 7 {
|
||||
1..5 => "small",
|
||||
6..10 => "medium",
|
||||
_ => "large"
|
||||
}
|
||||
assert result2 == "medium"
|
||||
|
||||
// Test 3: Box destructuring
|
||||
local user = new UserBox("Alice", 25)
|
||||
local greeting = match user {
|
||||
UserBox(name, age) => "Hello " + name + "!",
|
||||
_ => "Hello stranger!"
|
||||
}
|
||||
assert greeting == "Hello Alice!"
|
||||
|
||||
// Test 4: ガード条件
|
||||
local result4 = match 15 {
|
||||
x if x < 10 => "small",
|
||||
x if x < 20 => "medium",
|
||||
_ => "large"
|
||||
}
|
||||
assert result4 == "medium"
|
||||
```
|
||||
|
||||
### エラーケース
|
||||
```nyash
|
||||
// 網羅性エラー（意図的）
|
||||
match value {
|
||||
0 => "zero"
|
||||
// エラー: 他のケースが網羅されていない
|
||||
}
|
||||
|
||||
// 型エラー（意図的）
|
||||
match string_value {
|
||||
42 => "number" // エラー: 型が合わない
|
||||
}
|
||||
|
||||
// 到達不可能コード（意図的）
|
||||
match value {
|
||||
_ => "catch all",
|
||||
0 => "unreachable" // 警告: 到達不可能
|
||||
}
|
||||
```
|
||||
|
||||
## 🔗 マクロシステムとの統合準備
|
||||
|
||||
### AST Pattern Matching API
|
||||
|
||||
Pattern Matchingが完成すると、マクロ実装で以下のAPIが使用可能になる：
|
||||
|
||||
```rust
|
||||
// マクロでのAST操作例
|
||||
fn expand_derive_equals(input: &AstNode) -> Result<AstNode> {
|
||||
match input {
|
||||
AstNode::BoxDef { name, fields, .. } => {
|
||||
// パターンマッチングでBoxの構造を安全に分解
|
||||
let method_body = generate_equals_body(fields)?;
|
||||
Ok(AstNode::MethodDef {
|
||||
name: "equals".to_string(),
|
||||
body: method_body,
|
||||
..
|
||||
})
|
||||
},
|
||||
_ => Err("@derive can only be applied to box definitions")
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### マクロ展開での活用例
|
||||
```nyash
|
||||
// マクロが受け取るAST
|
||||
box UserBox {
|
||||
name: StringBox
|
||||
age: IntegerBox
|
||||
}
|
||||
|
||||
// パターンマッチングによる安全な変換
|
||||
match target_ast {
|
||||
BoxDef(name, fields) => {
|
||||
match fields {
|
||||
[Field("name", StringBox), Field("age", IntegerBox)] => {
|
||||
// 特定の構造に対する最適化生成
|
||||
generate_optimized_equals(name, fields)
|
||||
},
|
||||
_ => {
|
||||
// 汎用的な生成
|
||||
generate_generic_equals(name, fields)
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 📋 完了条件と受け入れ基準
|
||||
|
||||
### Phase PM.1完了条件
|
||||
- [ ] 基本的なmatch式が動作
|
||||
- [ ] リテラル・変数・ワイルドカードパターン実装
|
||||
- [ ] MIR14への正常なLowering
|
||||
- [ ] PyVM・LLVMバックエンドで実行可能
|
||||
|
||||
### Phase PM.2完了条件
|
||||
- [ ] Box destructuringが動作
|
||||
- [ ] 範囲パターン・ガード条件実装
|
||||
- [ ] 網羅性チェックの基本実装
|
||||
- [ ] 複雑なネストパターンの処理
|
||||
|
||||
### 最終受け入れ基準
|
||||
- [ ] 全テストケースの通過
|
||||
- [ ] エラーメッセージの品質確保
|
||||
- [ ] パフォーマンス基準の達成
|
||||
- [ ] マクロシステム実装への準備完了
|
||||
|
||||
## 🚀 次のステップ
|
||||
|
||||
### Pattern Matching完了後
|
||||
1. **AST操作基盤実装**（Phase 16.2）
|
||||
2. **HIRパッチエンジン設計**（Phase 16.3）
|
||||
3. **@derive(Equals)最小実装**（Phase 16.4）
|
||||
|
||||
### 期待される効果
|
||||
- **マクロ実装の土台**が確実に構築される
|
||||
- **複雑なAST操作**が安全かつ簡潔に記述可能
|
||||
- **コード品質**の大幅な向上
|
||||
- **開発効率**の革命的改善
|
||||
|
||||
---
|
||||
|
||||
**Pattern Matching基盤により、Nyash Macro Revolutionの成功が確実になる。**
|
||||
|
||||
*「まず土台を固める」- 全AI賢者の一致した戦略的判断。*
|
||||
@ -0,0 +1,132 @@
|
||||
# Phase 16: Macro Revolution - 世界最強マクロ言語への道
|
||||
|
||||
**開始日**: 2025-09-18
|
||||
**ステータス**: 計画中
|
||||
**目標**: Box-Based Macro Systemにより、Lisp/Rust/C++/Nim/Juliaを超越する
|
||||
|
||||
## 🔥 革命の発端
|
||||
|
||||
2025年9月18日、Nyashの調査中に**マクロ機能が存在しない**ことが判明。これを「第4の革命」の機会と捉え、世界最強のマクロ言語を目指すPhase 16が誕生。
|
||||
|
||||
### 🌟 これまでの革命
|
||||
1. **Property System革命**: stored/computed/once/birth_once統一構文
|
||||
2. **Python統合革命**: @property/@cached_property完全マッピング
|
||||
3. **Pattern Matching革命**: ChatGPT提案（実装予定）
|
||||
4. **🆕 Macro System革命**: 今回のPhase 16
|
||||
|
||||
## 🎯 目標：5つの最強言語を超越
|
||||
|
||||
| 言語 | 強み | Nyashでの超越方法 |
|
||||
|------|------|-------------------|
|
||||
| **Lisp** | homoiconicity | BoxがAST表現 → コード=Box |
|
||||
| **Rust** | 型安全derive | Property System + 型情報 |
|
||||
| **C++** | 零オーバーヘッド | LLVM最適化 + Box統一 |
|
||||
| **Nim** | 読みやすさ | Box記法 → より直感的 |
|
||||
| **Julia** | 科学計算特化 | Python統合 → ライブラリ活用 |
|
||||
|
||||
## 🌟 Box-Based Macro の革新性
|
||||
|
||||
### 世界初の特徴
|
||||
```nyash
|
||||
// 🚀 マクロが一等市民のBox
|
||||
box CustomMacroBox {
|
||||
template: StringBox
|
||||
|
||||
// computed: Property SystemとMacro Systemの融合！
|
||||
expanded_code: StringBox { expand(me.template) }
|
||||
|
||||
// once: 重いコンパイル処理をキャッシュ
|
||||
once compiled_ast: ASTBox { compile(me.expanded_code) }
|
||||
|
||||
// birth_once: マクロライブラリの事前読み込み
|
||||
birth_once macro_lib: MacroLibBox { load_stdlib() }
|
||||
}
|
||||
```
|
||||
|
||||
### 独自の革新要素
|
||||
- **Everything is Box**: マクロもBoxとして統一
|
||||
- **Property System統合**: リアルタイム展開 + キャッシュ
|
||||
- **型安全性**: `MacroBox<InputAst, OutputAst>`
|
||||
- **Visual debugging**: 展開ステップの可視化
|
||||
- **Live macro**: ファイル変更でリアルタイム更新
|
||||
|
||||
## 📋 実装ロードマップ
|
||||
|
||||
### **Phase A: AST基盤構築**（1週間）
|
||||
- AST Pattern/Unifier（変数/ワイルドカード）
|
||||
- Quasi-quote/unquote、AST Builder
|
||||
- Rewriter（停止条件/置換）
|
||||
|
||||
### **Phase B: 最小マクロシステム**（1-2週間）
|
||||
- マクロ定義/登録/解決（関数風）
|
||||
- 簡易衛生（gensym）+ 再帰上限
|
||||
- エラー設計（Span指向）
|
||||
|
||||
### **Phase C: Box-Based Macro完成**（1-2週間）
|
||||
- 属性マクロ（宣言/プロパティ）
|
||||
- MacroBox（型付きAPI）
|
||||
- デシュガ（pattern matching等）
|
||||
|
||||
### **Phase D: 高機能化**（以降）
|
||||
- 本格衛生（SyntaxContext）
|
||||
- 外部手続きマクロ（JSON AST）
|
||||
- AI支援マクロ生成
|
||||
|
||||
## 🤖 AI協働の成果
|
||||
|
||||
### Gemini洞察（言語設計）
|
||||
- Property×Macro統合の合理性確認
|
||||
- MacroBox一等市民化の革新性評価
|
||||
- Pattern Matching優先実装の推奨
|
||||
|
||||
### Codex洞察（実装戦略）
|
||||
- 技術的実現可能性の確認
|
||||
- 段階的実装ロードマップ
|
||||
- 工数見積もり（最小2-3週間、充実4-6週間）
|
||||
|
||||
## 🎯 成功指標
|
||||
|
||||
### Phase A完了時
|
||||
- AST操作ツールのユニットテスト通過
|
||||
- Span一貫性の確保
|
||||
|
||||
### Phase B完了時
|
||||
- マクロ→通常構文→MIR14が既存スモークと一致
|
||||
- PyVM/LLVM両方で差分なし
|
||||
|
||||
### Phase C完了時
|
||||
- 属性マクロでProperty宣言の糖衣実装
|
||||
- MacroBoxで実例1つ動作
|
||||
|
||||
### 最終目標
|
||||
```nyash
|
||||
// 🎯 世界最強マクロの証明
|
||||
@live_derive(Equals, ToString, Clone)
|
||||
@python_bridge(numpy, pandas)
|
||||
@visual_debug(expand_steps=true)
|
||||
box RevolutionaryBox {
|
||||
// Property System + Macro System完全融合
|
||||
once ai_methods: MethodBox { AI.generate(me.type()) }
|
||||
computed quality: QualityBox { analyze(me.generated_code) }
|
||||
}
|
||||
```
|
||||
|
||||
## 📚 関連ドキュメント
|
||||
|
||||
### 🎯 実装計画
|
||||
- **[統合実装ロードマップ](IMPLEMENTATION_ROADMAP.md)** - 全AI相談結果を統合した実装戦略
|
||||
- **[Pattern Matching基盤計画](PATTERN_MATCHING_FOUNDATION.md)** - マクロ実装の必須前提条件
|
||||
|
||||
### 🤖 AI相談結果
|
||||
- **[ChatGPT最強思考モード分析](CHATGPT_CONSULTATION.md)** - 6つのマクロタイプ評価と実装優先度
|
||||
- **[Gemini哲学的検討](GEMINI_CONSULTATION.md)** - Property×Macro統合の合理性検証
|
||||
- **[Codex技術分析](CODEX_CONSULTATION.md)** - 実装可能性と技術的制約
|
||||
|
||||
### 🌟 設計ドキュメント
|
||||
- **[マクロ実例集](macro-examples.md)** - 6つの革命的マクロタイプの具体例
|
||||
|
||||
---
|
||||
|
||||
**🚀 Nyash Macro Revolution - Everything is Box, Everything is Macro!**
|
||||
|
||||
*目標：3週間で世界最強のマクロ言語を実現する*
|
||||
@ -0,0 +1,428 @@
|
||||
# Nyash Macro Examples - 世界最強マクロ言語への具体例
|
||||
|
||||
**更新日**: 2025-09-18
|
||||
**ステータス**: 設計完了、実装待ち
|
||||
|
||||
## 🎯 マクロ分類と優先度
|
||||
|
||||
| 優先度 | マクロ | 実用性 | 実装コスト | 特徴 |
|
||||
|--------|--------|--------|------------|------|
|
||||
| 🥇 **MVP** | @derive | ⭐⭐⭐⭐ | ⭐⭐ | ボイラープレート除去 |
|
||||
| 🥈 **早期** | @validate | ⭐⭐⭐⭐ | ⭐⭐⭐ | 型安全・入力品質 |
|
||||
| 🥈 **早期** | @config_schema | ⭐⭐⭐⭐ | ⭐⭐ | 実アプリ即効 |
|
||||
| 🥉 **段階** | @api_client | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | プロダクション |
|
||||
| 🥉 **段階** | @sql_schema | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | 企業利用 |
|
||||
| 🏅 **実験** | @html_dsl | ⭐⭐⭐ | ⭐⭐⭐ | 表現力・デモ |
|
||||
|
||||
## 🔥 1. @derive系マクロ（MVP最優先）
|
||||
|
||||
### 基本例
|
||||
```nyash
|
||||
@derive(Equals, ToString, Clone, Json)
|
||||
box UserBox {
|
||||
name: StringBox
|
||||
age: IntegerBox
|
||||
email: StringBox
|
||||
}
|
||||
```
|
||||
|
||||
### 自動生成されるメソッド
|
||||
```nyash
|
||||
// @derive(Equals) → equals method
|
||||
method equals(other: UserBox) -> BoolBox {
|
||||
return me.name == other.name &&
|
||||
me.age == other.age &&
|
||||
me.email == other.email
|
||||
}
|
||||
|
||||
// @derive(ToString) → toString method
|
||||
method toString() -> StringBox {
|
||||
return "UserBox(name=" + me.name +
|
||||
", age=" + me.age +
|
||||
", email=" + me.email + ")"
|
||||
}
|
||||
|
||||
// @derive(Clone) → clone method
|
||||
method clone() -> UserBox {
|
||||
return new UserBox(me.name, me.age, me.email)
|
||||
}
|
||||
|
||||
// @derive(Json) → toJson/fromJson methods
|
||||
method toJson() -> JsonBox {
|
||||
return JsonBox.object([
|
||||
["name", me.name],
|
||||
["age", me.age],
|
||||
["email", me.email]
|
||||
])
|
||||
}
|
||||
```
|
||||
|
||||
### Property System統合
|
||||
```nyash
|
||||
@derive(Equals, ToString)
|
||||
box AdvancedBox {
|
||||
// stored fields
|
||||
name: StringBox
|
||||
|
||||
// computed fields も自動でderiveに含まれる！
|
||||
display_name: StringBox { me.name.toUpperCase() }
|
||||
|
||||
// once fields も含まれる
|
||||
once uuid: StringBox { generateUUID() }
|
||||
}
|
||||
|
||||
// 生成されるequalsはcomputed/onceも含む
|
||||
method equals(other: AdvancedBox) -> BoolBox {
|
||||
return me.name == other.name &&
|
||||
me.display_name == other.display_name &&
|
||||
me.uuid == other.uuid // onceプロパティも比較
|
||||
}
|
||||
```
|
||||
|
||||
## 🛡️ 2. @validate系マクロ（型安全革命）
|
||||
|
||||
### 基本バリデーション
|
||||
```nyash
|
||||
@validate
|
||||
box UserBox {
|
||||
@required @email
|
||||
email: StringBox
|
||||
|
||||
@range(0, 150) @required
|
||||
age: IntegerBox
|
||||
|
||||
@min_length(8) @optional
|
||||
password: StringBox
|
||||
|
||||
@pattern("^[a-zA-Z]+$") @required
|
||||
name: StringBox
|
||||
}
|
||||
```
|
||||
|
||||
### 自動生成されるバリデーション
|
||||
```nyash
|
||||
// setter methods with validation
|
||||
method set_email(value: StringBox) {
|
||||
if value.length() == 0 {
|
||||
throw new ValidationError("email is required")
|
||||
}
|
||||
if !value.contains("@") {
|
||||
throw new ValidationError("invalid email format")
|
||||
}
|
||||
me.email = value
|
||||
}
|
||||
|
||||
method set_age(value: IntegerBox) {
|
||||
if value < 0 || value > 150 {
|
||||
throw new ValidationError("age must be between 0 and 150")
|
||||
}
|
||||
me.age = value
|
||||
}
|
||||
|
||||
method set_name(value: StringBox) {
|
||||
if value.length() == 0 {
|
||||
throw new ValidationError("name is required")
|
||||
}
|
||||
if !value.matches("^[a-zA-Z]+$") {
|
||||
throw new ValidationError("name must contain only letters")
|
||||
}
|
||||
me.name = value
|
||||
}
|
||||
|
||||
// bulk validation method
|
||||
method validate() -> Result<BoolBox, ValidationErrorBox> {
|
||||
try {
|
||||
me.validate_email()
|
||||
me.validate_age()
|
||||
me.validate_name()
|
||||
return Ok(true)
|
||||
} catch(ValidationError e) {
|
||||
return Err(e)
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Property System統合
|
||||
```nyash
|
||||
@validate
|
||||
box ConfigBox {
|
||||
@required @env("DATABASE_URL")
|
||||
database_url: StringBox
|
||||
|
||||
// computed property でもバリデーション適用
|
||||
@range(1, 100)
|
||||
max_connections: IntegerBox { me.calculate_connections() }
|
||||
|
||||
// validation はcomputed propertyの計算時に実行
|
||||
}
|
||||
```
|
||||
|
||||
## ⚙️ 3. @config_schema系マクロ（実アプリ即効）
|
||||
|
||||
### 環境変数ベース設定
|
||||
```nyash
|
||||
@config_schema
|
||||
box AppConfigBox {
|
||||
@env("DATABASE_URL") @required
|
||||
database_url: StringBox
|
||||
|
||||
@env("REDIS_URL") @default("redis://localhost:6379")
|
||||
redis_url: StringBox
|
||||
|
||||
@env("DEBUG") @default(false) @parse_bool
|
||||
debug_mode: BoolBox
|
||||
|
||||
@env("MAX_CONNECTIONS") @default(100) @range(1, 1000) @parse_int
|
||||
max_connections: IntegerBox
|
||||
|
||||
@env("LOG_LEVEL") @default("INFO") @enum(["DEBUG", "INFO", "WARN", "ERROR"])
|
||||
log_level: StringBox
|
||||
}
|
||||
```
|
||||
|
||||
### 自動生成される設定ローダー
|
||||
```nyash
|
||||
// 静的ローダーメソッド
|
||||
static method load() -> Result<AppConfigBox, ConfigErrorBox> {
|
||||
local config = new AppConfigBox()
|
||||
|
||||
// required環境変数チェック
|
||||
local database_url = EnvBox.get("DATABASE_URL")
|
||||
if database_url.is_none() {
|
||||
return Err(new ConfigError("DATABASE_URL is required"))
|
||||
}
|
||||
config.database_url = database_url.unwrap()
|
||||
|
||||
// デフォルト値付き設定
|
||||
config.redis_url = EnvBox.get_or("REDIS_URL", "redis://localhost:6379")
|
||||
config.debug_mode = EnvBox.get_or("DEBUG", "false").parse_bool()
|
||||
config.max_connections = EnvBox.get_or("MAX_CONNECTIONS", "100").parse_int()
|
||||
|
||||
// バリデーション実行
|
||||
if config.max_connections < 1 || config.max_connections > 1000 {
|
||||
return Err(new ConfigError("MAX_CONNECTIONS must be between 1 and 1000"))
|
||||
}
|
||||
|
||||
return Ok(config)
|
||||
}
|
||||
|
||||
// 設定リロードメソッド
|
||||
method reload() -> Result<BoolBox, ConfigErrorBox> {
|
||||
local new_config = AppConfigBox.load()
|
||||
if new_config.is_err() {
|
||||
return Err(new_config.unwrap_err())
|
||||
}
|
||||
|
||||
// 現在の設定を更新
|
||||
local config = new_config.unwrap()
|
||||
me.database_url = config.database_url
|
||||
me.redis_url = config.redis_url
|
||||
// ... other fields
|
||||
|
||||
return Ok(true)
|
||||
}
|
||||
```
|
||||
|
||||
### Property System統合
|
||||
```nyash
|
||||
@config_schema
|
||||
box LiveConfigBox {
|
||||
@env("API_HOST") @required
|
||||
api_host: StringBox
|
||||
|
||||
@env("API_PORT") @default(8080) @parse_int
|
||||
api_port: IntegerBox
|
||||
|
||||
// computed: 設定から自動でURL生成
|
||||
api_url: StringBox {
|
||||
"http://" + me.api_host + ":" + me.api_port
|
||||
}
|
||||
|
||||
// once: 重い初期化処理
|
||||
once connection_pool: PoolBox {
|
||||
createPool(me.api_url, me.max_connections)
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 🌐 4. @api_client系マクロ（プロダクション級）
|
||||
|
||||
### OpenAPI仕様ベース生成
|
||||
```nyash
|
||||
@api_client("https://petstore.swagger.io/v2/swagger.json")
|
||||
box PetStoreApiBox {
|
||||
base_url: StringBox = "https://petstore.swagger.io/v2"
|
||||
api_key: StringBox
|
||||
|
||||
// 以下のメソッドが自動生成される：
|
||||
// getPetById(id: IntegerBox) -> Promise<PetBox>
|
||||
// addPet(pet: PetBox) -> Promise<PetBox>
|
||||
// updatePet(pet: PetBox) -> Promise<PetBox>
|
||||
// deletePet(id: IntegerBox) -> Promise<BoolBox>
|
||||
// findPetsByStatus(status: StringBox) -> Promise<ArrayBox<PetBox>>
|
||||
}
|
||||
```
|
||||
|
||||
### 自動生成されるAPIメソッド
|
||||
```nyash
|
||||
// GET /pet/{petId}
|
||||
method getPetById(id: IntegerBox) -> Promise<PetBox> {
|
||||
local url = me.base_url + "/pet/" + id.toString()
|
||||
local request = HttpRequestBox.new()
|
||||
.url(url)
|
||||
.method("GET")
|
||||
.header("api_key", me.api_key)
|
||||
|
||||
return HttpClientBox.send(request)
|
||||
.then(|response| {
|
||||
if response.status() != 200 {
|
||||
throw new ApiError("Failed to get pet: " + response.status())
|
||||
}
|
||||
return PetBox.fromJson(response.body())
|
||||
})
|
||||
}
|
||||
|
||||
// POST /pet
|
||||
method addPet(pet: PetBox) -> Promise<PetBox> {
|
||||
local url = me.base_url + "/pet"
|
||||
local request = HttpRequestBox.new()
|
||||
.url(url)
|
||||
.method("POST")
|
||||
.header("Content-Type", "application/json")
|
||||
.header("api_key", me.api_key)
|
||||
.body(pet.toJson().toString())
|
||||
|
||||
return HttpClientBox.send(request)
|
||||
.then(|response| {
|
||||
if response.status() != 200 {
|
||||
throw new ApiError("Failed to add pet: " + response.status())
|
||||
}
|
||||
return PetBox.fromJson(response.body())
|
||||
})
|
||||
}
|
||||
```
|
||||
|
||||
## 🗄️ 5. @sql_schema系マクロ（企業級）
|
||||
|
||||
### データベーススキーマベース生成
|
||||
```nyash
|
||||
@sql_schema("database_schema.json")
|
||||
box UserQueryBox {
|
||||
connection: DatabaseBox
|
||||
|
||||
// 以下のメソッドが型安全に自動生成される
|
||||
}
|
||||
```
|
||||
|
||||
### 自動生成される型安全クエリビルダー
|
||||
```nyash
|
||||
// SELECT with type safety
|
||||
method findByAge(min_age: IntegerBox, max_age: IntegerBox) -> Promise<ArrayBox<UserBox>> {
|
||||
local query = "SELECT id, name, email, age FROM users WHERE age BETWEEN ? AND ?"
|
||||
return me.connection.query(query, [min_age, max_age])
|
||||
.then(|rows| {
|
||||
return rows.map(|row| {
|
||||
return UserBox.new(
|
||||
row.get_int("id"),
|
||||
row.get_string("name"),
|
||||
row.get_string("email"),
|
||||
row.get_int("age")
|
||||
)
|
||||
})
|
||||
})
|
||||
}
|
||||
|
||||
// Fluent query builder
|
||||
method where(condition: QueryConditionBox) -> UserQueryBuilderBox {
|
||||
return new UserQueryBuilderBox(me.connection)
|
||||
.add_condition(condition)
|
||||
}
|
||||
|
||||
// Type-safe usage
|
||||
local users = await user_query
|
||||
.where(UserQuery.age.greater_than(18))
|
||||
.where(UserQuery.name.like("%john%"))
|
||||
.orderBy(UserQuery.created_at.desc())
|
||||
.limit(10)
|
||||
.execute() // Promise<ArrayBox<UserBox>>
|
||||
```
|
||||
|
||||
## 🎨 6. @html_dsl系マクロ（表現力デモ）
|
||||
|
||||
### HTML生成DSL
|
||||
```nyash
|
||||
@html_dsl
|
||||
box WebPageBox {
|
||||
title: StringBox = "My Page"
|
||||
users: ArrayBox<UserBox>
|
||||
|
||||
// computed: HTML生成
|
||||
content: StringBox {
|
||||
html {
|
||||
head {
|
||||
title { me.title }
|
||||
meta(charset="utf-8")
|
||||
}
|
||||
body {
|
||||
div(class="container") {
|
||||
h1 { "User List" }
|
||||
ul(class="user-list") {
|
||||
for user in me.users {
|
||||
li(class="user-item") {
|
||||
span(class="name") { user.name }
|
||||
span(class="age") { "Age: " + user.age }
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 自動生成されるHTML Builder
|
||||
```nyash
|
||||
// HTML builder methods
|
||||
method html(content: () -> StringBox) -> StringBox {
|
||||
return "<html>" + content.call() + "</html>"
|
||||
}
|
||||
|
||||
method div(attributes: MapBox, content: () -> StringBox) -> StringBox {
|
||||
local attrs = me.build_attributes(attributes)
|
||||
return "<div" + attrs + ">" + content.call() + "</div>"
|
||||
}
|
||||
|
||||
method build_attributes(attrs: MapBox) -> StringBox {
|
||||
local result = ""
|
||||
attrs.each_pair(|key, value| {
|
||||
result = result + " " + key + "=\"" + value + "\""
|
||||
})
|
||||
return result
|
||||
}
|
||||
```
|
||||
|
||||
## 🚀 マクロの革新的特徴
|
||||
|
||||
### 1. Property System完全統合
|
||||
- **stored/computed/once/birth_once** 全てでマクロ適用可能
|
||||
- **リアルタイム更新**: ファイル変更でマクロ再展開
|
||||
|
||||
### 2. Box-First一貫性
|
||||
- **MacroBox**: マクロ自体が一等市民のBox
|
||||
- **型安全性**: `MacroBox<InputAst, OutputAst>`
|
||||
|
||||
### 3. Visual Development
|
||||
- **`nyash --expand`**: 展開結果の可視化
|
||||
- **`NYASH_MACRO_TRACE=1`**: ステップバイステップ追跡
|
||||
|
||||
### 4. 段階的導入
|
||||
- **最小MVP**: @derive(Equals)から開始
|
||||
- **実用拡張**: @validate, @config_schema追加
|
||||
- **高機能化**: @api_client, @sql_schema実装
|
||||
|
||||
---
|
||||
|
||||
**これらのマクロ例により、Nyashは日常的な開発から企業級アプリケーションまで、全レベルでの生産性革命を実現する。**
|
||||
|
||||
*Property System × Macro System統合により、他言語では不可能な表現力と実用性を両立。*
|
||||
Reference in New Issue
Block a user