gui: add EguiBox TypeBox plugin (Windows egui stub)\n\n- plugins: add nyash-egui-plugin with TypeBox (resolve/invoke_id), Windows path for real window via eframe; stub on other OS\n- apps: add apps/egui-hello sample (open→uiLabel→run→close)\n- loader: improve Windows DLL resolution (target triples: x86_64/aarch64 msvc) and lib→dll mapping\n- tests: expand TypeBox vs TLV diff tests up to FileBox; all green\n- docs: update CURRENT_TASK checklist (diff tests completed)\n- config: nyash.toml add EguiBox (type_id=70), plugin registry and methods
This commit is contained in:
Moe Charm
@ -1,4 +1,67 @@
|
||||
# 🎯 CURRENT TASK - 2025-09-01 Snapshot（Async Task System / Phase 11.7 + Plugin-First）
|
||||
# 🎯 CURRENT TASK - 2025-09-03 Snapshot（Phase 12.05: 旧C ABI→新C ABI(TypeBox) 変換 + 差分テスト拡充）
|
||||
|
||||
目的: 既存C ABIプラグインを「統一TypeBox C ABI」に段階移行。LoaderのTypeBoxプローブ + `invoke_id` 優先経路を活用し、コアBox（Array/Map/String/Integer/Console）から順に resolve/invoke_id を実装していく。
|
||||
|
||||
## 進捗（現状）
|
||||
- Loader: TypeBoxシンボル自動プローブ + `invoke_id` 優先 組込み済み。
|
||||
- MapBox: `getS/hasS` を TypeBoxで提供（`nyash_typebox_MapBox`）。
|
||||
- Nyash ABI基礎テスト: スロット解決と Array返却検証を追加（`src/tests/nyash_abi_basic.rs`）。
|
||||
|
||||
## スコープ（段階移行 + 差分テスト）
|
||||
1) 変換済み（TypeBox対応済み）
|
||||
- MapBox: size/len/get/has/set（string/intキー対応）
|
||||
- ArrayBox: len/length/get/set/push
|
||||
- StringBox: length/concat/toUtf8
|
||||
- IntegerBox: get/set
|
||||
- ConsoleBox: println/log
|
||||
2) 差分テストの拡充（TLV vs TypeBox 同値性）
|
||||
- 追加対象（純粋/副作用少なめを優先）
|
||||
- MathBox: sqrt/sin/cos/round
|
||||
- EncodingBox: base64/hex encode/decode
|
||||
- RegexBox: isMatch/find（Result/Bool/文字列）
|
||||
- PathBox: join/dirname/basename/isAbs/normalize
|
||||
- TOMLBox: parse/get/toJson（Result.Ok/Err）
|
||||
- TimeBox: now（許容差内で比較／厳密比較回避）
|
||||
- CounterBox: singletonの基本挙動
|
||||
- FileBox: read/write/close（tmpdir使用で副作用隔離）
|
||||
3) Python/Net/Socket 系の差分テストは対象外（開発中のため今回スキップ）
|
||||
|
||||
## DoD（Definition of Done）
|
||||
1) 上記コアBox（Map/Array/String/Integer/Console）に加え、Math/Encoding/Regex/Path/TOML/Time/Counter/File の差分テストが全てGreen（VM）。
|
||||
2) `NYASH_DISABLE_TYPEBOX=1` によるTLV経路との同値性が確認できる（代表メソッド各1-2本ずつ）。
|
||||
3) FileBox差分テストは一時ディレクトリで副作用隔離（クリーンアップ含む）。
|
||||
4) フォールバック互換（未実装メソッドはTLV経路で動作）を維持。
|
||||
|
||||
## タスク（小粒）
|
||||
- [x] ArrayBox TypeBox: `nyash_typebox_ArrayBox`（resolve/get,len,set,push → invoke_id）
|
||||
- [x] StringBox TypeBox: `nyash_typebox_StringBox`（resolve/length,concat,toUtf8）
|
||||
- [x] IntegerBox TypeBox: `nyash_typebox_IntegerBox`（resolve/get,set）
|
||||
- [x] ConsoleBox TypeBox: `nyash_typebox_ConsoleBox`（resolve/log,println）
|
||||
- [x] MapBox TypeBox 拡張: size/len/get/has/set 追加（getS/hasSを含む）
|
||||
- [x] 差分テスト: Map/Array/String/Integer/Console（VM）
|
||||
- [x] 差分テスト: MathBox（sqrt/sin/cos/round）
|
||||
- [x] 差分テスト: EncodingBox（base64/hex encode/decode）
|
||||
- [x] 差分テスト: RegexBox（isMatch/find）
|
||||
- [x] 差分テスト: PathBox（join/dirname/basename/isAbs/normalize）
|
||||
- [x] 差分テスト: TOMLBox（parse/get/toJson）
|
||||
- [x] 差分テスト: TimeBox（now: 許容差内）
|
||||
- [x] 差分テスト: CounterBox（singleton挙動）
|
||||
- [x] 差分テスト: FileBox（tmpdirで read/write/close）
|
||||
|
||||
## 実行メモ
|
||||
```bash
|
||||
cargo build --release --features cranelift-jit
|
||||
# 各プラグインのビルド
|
||||
cargo build -p nyash-array-plugin -p nyash-string-plugin -p nyash-integer-plugin -p nyash-console-plugin -p nyash-map-plugin --release
|
||||
|
||||
# 差分テスト（狙い撃ち）
|
||||
cargo test --lib typebox_tlv_diff -- --nocapture
|
||||
# TLV 経路のみで確認したい場合は環境変数で切替
|
||||
NYASH_DISABLE_TYPEBOX=1 cargo test --lib typebox_tlv_diff -- --nocapture
|
||||
```
|
||||
|
||||
## 次のマイルストーン（参照）
|
||||
- Phase 12 Final: Nyash ABI(TypeBox) で egui をサポート（Windows GUI表示）。本タスク完了後に着手（Python/Netは除外）。
|
||||
|
||||
このスナップショットは Phase 11.7 の Async Task System 進捗を反映しました。詳細仕様/計画は下記を参照。
|
||||
- SPEC: docs/development/roadmap/phases/phase-11.7_jit_complete/async_task_system/SPEC.md
|
||||
|
||||
@ -26,6 +26,9 @@ Purpose: Claude×Copilot×ChatGPT×Gemini×Codex協調開発の総合ロード
|
||||
| 11.8 | 📅予定 | MIR整理（Core-15→Core-13） | [phase-11.8_mir_cleanup/](phase-11.8_mir_cleanup/) |
|
||||
| 12 | 🔄進行中 | TypeBox統合ABI・セルフホスティング準備 | [phase-12/](phase-12/) |
|
||||
| 12.5 | 📅予定 | MIR15最適化戦略 | [phase-12.5/](phase-12.5/) |
|
||||
| 12.7 | 📅予定 | AI-Nyash Compact Notation Protocol (ANCP) | [phase-12.7/](phase-12.7/) |
|
||||
| 13 | 📅予定 | Nyashブラウザー革命 | [phase-13/](phase-13/) |
|
||||
| 14 | 📅予定 | パッケージング・CI改善 | [phase-14/](phase-14/) |
|
||||
| 15 | 🌟実現可能 | セルフホスティング（C実装ABI経由） | [phase-15/](phase-15/) |
|
||||
|
||||
---
|
||||
|
||||
183
docs/development/roadmap/phases/phase-12.7/README.md
Normal file
183
docs/development/roadmap/phases/phase-12.7/README.md
Normal file
@ -0,0 +1,183 @@
|
||||
# Phase 12.7: AI-Nyash Compact Notation Protocol (ANCP)
|
||||
|
||||
## 📋 概要
|
||||
|
||||
AIとNyashの効率的な通信のための圧縮記法プロトコル。予約語を1-2文字の記号に変換し、トークン数を50-90%削減。さらに副次的効果として、コード整形機能とスモークテスト統合による品質保証も実現。
|
||||
|
||||
## 🎯 なぜPhase 12.7なのか？
|
||||
|
||||
### タイミングの完璧さ
|
||||
- **Phase 12**: TypeBox統合ABI完了（安定した基盤）
|
||||
- **Phase 12.5**: MIR15最適化（コンパクトな中間表現）
|
||||
- **Phase 12.7**: ANCP（AIとの架け橋）← **ここ！**
|
||||
- **Phase 13**: ブラウザー革命（別の大きな挑戦）
|
||||
- **Phase 15**: セルフホスティング（ANCPで書かれた超小型コンパイラ！）
|
||||
|
||||
### 戦略的価値
|
||||
1. **即効性**: 実装が比較的簡単で、すぐに効果が出る
|
||||
2. **相乗効果**: Phase 15のセルフホスティングと組み合わせて究極の圧縮
|
||||
3. **AI協働**: Claude/ChatGPT/Gemini/Codexとの開発効率が劇的に向上
|
||||
|
||||
## 🌟 革命的インパクト
|
||||
|
||||
### 数値で見る効果
|
||||
```nyash
|
||||
// 通常のNyash（約80文字）
|
||||
box NyashCompiler {
|
||||
compile(source) {
|
||||
local ast = me.parse(source)
|
||||
local mir = me.lower(ast)
|
||||
return me.codegen(mir)
|
||||
}
|
||||
}
|
||||
|
||||
// ANCP記法（約40文字） - 50%削減！
|
||||
$NyashCompiler{compile(src){l ast=m.parse(src)l mir=m.lower(ast)r m.codegen(mir)}}
|
||||
|
||||
// 夢の組み合わせ：
|
||||
// Phase 15: 80k行 → 20k行（75%削減）
|
||||
// + ANCP: 20k行 → 10k行相当（さらに50%削減）
|
||||
// = 最終的に87.5%削減！世界一小さい実用コンパイラ！
|
||||
```
|
||||
|
||||
### AIコンテキスト革命
|
||||
- **GPT-4** (128k tokens): 通常2万行 → ANCP で4万行扱える！
|
||||
- **Claude** (200k tokens): 通常4万行 → ANCP で8万行扱える！
|
||||
- **Nyash全体のソースコード** がAIのコンテキストに収まる！
|
||||
|
||||
## 📊 主要成果物
|
||||
|
||||
### コア実装
|
||||
- [ ] ANCP Transcoder（双方向変換器）
|
||||
- [ ] Lexer拡張（Dialect検出）
|
||||
- [ ] VSCode拡張（リアルタイム変換）
|
||||
- [ ] CLIツール（nyash2ancp/ancp2nyash）
|
||||
|
||||
### 品質保証
|
||||
- [ ] 往復テストスイート（100%一致保証）
|
||||
- [ ] スモークテスト統合
|
||||
- [ ] ファジングテスト
|
||||
- [ ] パフォーマンスベンチマーク
|
||||
|
||||
### AI連携
|
||||
- [ ] tiktoken最適化（実測ベース記号選定）
|
||||
- [ ] AIコード検証器
|
||||
- [ ] トレーニングデータ生成
|
||||
|
||||
## 🔧 技術的アプローチ
|
||||
|
||||
### 記号マッピング（最適化版）
|
||||
```
|
||||
【高頻度・基本】
|
||||
box → $ # Box定義（毎回出現）
|
||||
new → n # インスタンス生成
|
||||
me → m # 自己参照（超頻出）
|
||||
local → l # ローカル変数
|
||||
return → r # 戻り値
|
||||
|
||||
【構造系】
|
||||
from → @ # 継承/デリゲーション
|
||||
init → # # フィールド初期化
|
||||
birth → b # コンストラクタ
|
||||
static → S # 静的定義
|
||||
|
||||
【制御系】
|
||||
if → ? # 条件分岐
|
||||
else → : # else節
|
||||
loop → L # ループ
|
||||
override → O # オーバーライド
|
||||
```
|
||||
|
||||
### 実装優先順位
|
||||
|
||||
#### Phase 1: 最小実装（1週間）
|
||||
```rust
|
||||
// 20語の固定辞書で開始
|
||||
pub struct AncpTranscoder {
|
||||
mappings: HashMap<&'static str, &'static str>,
|
||||
}
|
||||
|
||||
impl AncpTranscoder {
|
||||
pub fn encode(&self, nyash: &str) -> String {
|
||||
// シンプルな置換から開始
|
||||
}
|
||||
|
||||
pub fn decode(&self, ancp: &str) -> String {
|
||||
// 逆変換
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### Phase 2: スマート変換（2週間）
|
||||
- コンテキスト認識（文字列内は変換しない）
|
||||
- 空白・コメント保持
|
||||
- エラー位置マッピング
|
||||
|
||||
#### Phase 3: ツール統合（2週間）
|
||||
- VSCode拡張（ホバーで元のコード表示）
|
||||
- CLIツール（--format=ancp オプション）
|
||||
- スモークテスト自動ANCP化
|
||||
|
||||
## 🔗 関連ドキュメント
|
||||
|
||||
- [ANCP技術仕様](technical-spec.md)
|
||||
- [実装計画](implementation-plan.md)
|
||||
- [AI統合ガイド](ai-integration-guide.md)
|
||||
- [元のアイデア文書](../../../ideas/new-features/2025-08-29-ai-compact-notation-protocol.md)
|
||||
|
||||
## 📅 実施スケジュール
|
||||
|
||||
### 即座に開始可能な理由
|
||||
1. **独立性**: 他のフェーズの完了を待つ必要なし
|
||||
2. **低リスク**: 既存コードに影響しない追加機能
|
||||
3. **高効果**: すぐにAI開発効率が向上
|
||||
|
||||
### マイルストーン
|
||||
- **Week 1**: 基本トランスコーダー実装
|
||||
- **Week 2**: パーサー統合・往復テスト
|
||||
- **Week 3**: ツール実装（CLI/VSCode）
|
||||
- **Week 4**: AI連携・最適化
|
||||
|
||||
## 💡 期待される成果
|
||||
|
||||
### 定量的
|
||||
- トークン削減率: 50-70%（目標）
|
||||
- AI開発効率: 2-3倍向上
|
||||
- コンテキスト容量: 2倍に拡大
|
||||
|
||||
### 定性的
|
||||
- AIがNyash全体を「理解」できる
|
||||
- 人間も慣れれば読み書き可能
|
||||
- 自動整形の副次効果
|
||||
|
||||
## 🌟 夢の実現
|
||||
|
||||
### Phase 15との究極コンボ
|
||||
```nyash
|
||||
// セルフホスティングコンパイラ（ANCP記法）
|
||||
// たった5行で完全なコンパイラ！
|
||||
$Compiler{
|
||||
c(s){
|
||||
r m.gen(m.low(m.parse(s)))
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
これが「世界一美しい箱」の究極形態にゃ！
|
||||
|
||||
### 将来の拡張
|
||||
- **ANCP v2**: 文脈依存の高度な圧縮
|
||||
- **AI専用方言**: モデル特化の最適化
|
||||
- **バイナリANCP**: さらなる圧縮
|
||||
|
||||
## 🚀 なぜ今すぐ始めるべきか
|
||||
|
||||
1. **AI時代の必須技術**: コンテキスト制限との戦い
|
||||
2. **開発効率の即効薬**: 今すぐ効果を実感
|
||||
3. **Nyashの差別化要因**: 他言語にない強み
|
||||
|
||||
> 「コードも箱に入れて、小さく美しく」- ANCP Philosophy
|
||||
|
||||
---
|
||||
|
||||
Phase 12.7は、Nyashを真のAI時代のプログラミング言語にする重要な一歩です。
|
||||
@ -0,0 +1,330 @@
|
||||
# AI Integration Guide for ANCP
|
||||
|
||||
## 🤖 AI開発者のためのANCP活用ガイド
|
||||
|
||||
### なぜANCPがAI開発を変えるのか
|
||||
|
||||
1. **コンテキスト容量2-3倍**: より多くのコードをAIに渡せる
|
||||
2. **理解速度向上**: パターンが明確で認識しやすい
|
||||
3. **生成効率向上**: 短い記号で素早くコード生成
|
||||
|
||||
## 📋 クイックリファレンス
|
||||
|
||||
### 最重要マッピング（必ず覚える）
|
||||
```
|
||||
$ = box # Box定義
|
||||
n = new # インスタンス生成
|
||||
m = me # 自己参照
|
||||
l = local # ローカル変数
|
||||
r = return # 戻り値
|
||||
```
|
||||
|
||||
### よく使うパターン
|
||||
```nyash
|
||||
// Nyash
|
||||
box Cat from Animal {
|
||||
init { name }
|
||||
birth(name) {
|
||||
me.name = name
|
||||
}
|
||||
}
|
||||
|
||||
// ANCP
|
||||
$Cat@Animal{
|
||||
#{name}
|
||||
b(name){m.name=name}
|
||||
}
|
||||
```
|
||||
|
||||
## 🎯 AI別最適化ガイド
|
||||
|
||||
### Claude (Anthropic)
|
||||
```markdown
|
||||
# Claudeへの指示例
|
||||
NyashコードをANCP記法で書いてください。以下のマッピングを使用：
|
||||
- box → $
|
||||
- new → n
|
||||
- me → m
|
||||
- local → l
|
||||
- return → r
|
||||
|
||||
コンテキスト: 200k tokens利用可能
|
||||
推奨: 大規模プロジェクト全体をANCPで渡す
|
||||
```
|
||||
|
||||
### ChatGPT (OpenAI)
|
||||
```markdown
|
||||
# ChatGPTへの指示例
|
||||
Use ANCP notation for Nyash code:
|
||||
;ancp:1.0 nyash:0.5;
|
||||
|
||||
Quick reference:
|
||||
$ = box, n = new, m = me, l = local, r = return
|
||||
|
||||
Context: 128k tokens (GPT-4)
|
||||
Strategy: Focus on core modules with ANCP
|
||||
```
|
||||
|
||||
### Gemini (Google)
|
||||
```markdown
|
||||
# Geminiへの深い考察依頼
|
||||
ANCPを使ったNyashコードの最適化を深く考えてください。
|
||||
トークン効率とコード美しさのバランスを重視。
|
||||
|
||||
特に注目:
|
||||
- $ (box) によるオブジェクト指向の簡潔表現
|
||||
- m (me) による自己参照の明確化
|
||||
```
|
||||
|
||||
### Codex/Copilot
|
||||
```python
|
||||
# .copilot/ancp_hints.py
|
||||
"""
|
||||
ANCP Quick Patterns:
|
||||
- $ClassName{...} = box ClassName { ... }
|
||||
- m.method() = me.method()
|
||||
- l var = value = local var = value
|
||||
- r value = return value
|
||||
"""
|
||||
```
|
||||
|
||||
## 💡 実践的な使い方
|
||||
|
||||
### 1. 大規模コードレビュー
|
||||
```bash
|
||||
# 全プロジェクトをANCPに変換してAIに渡す
|
||||
nyash2ancp -i src/ -o /tmp/review.ancp --recursive
|
||||
|
||||
# AIへのプロンプト
|
||||
"Review this ANCP code for performance issues:
|
||||
[/tmp/review.ancp の内容]"
|
||||
```
|
||||
|
||||
### 2. アーキテクチャ設計相談
|
||||
```ancp
|
||||
;ancp:1.0 nyash:0.5;
|
||||
// 新しいP2Pシステムの設計
|
||||
$P2PNetwork{
|
||||
#{nodes,dht}
|
||||
|
||||
connect(peer){
|
||||
l conn=n Connection(peer)
|
||||
m.nodes.add(conn)
|
||||
r conn
|
||||
}
|
||||
}
|
||||
|
||||
// AIへの質問
|
||||
"この設計でスケーラビリティの問題はありますか？"
|
||||
```
|
||||
|
||||
### 3. バグ修正依頼
|
||||
```ancp
|
||||
// バグのあるコード（ANCP）
|
||||
$Calculator{
|
||||
divide(a,b){
|
||||
r a/b // ゼロ除算チェックなし
|
||||
}
|
||||
}
|
||||
|
||||
// AIへの依頼
|
||||
"このANCPコードのバグを修正してください"
|
||||
```
|
||||
|
||||
## 📊 効果測定
|
||||
|
||||
### トークン削減の実例
|
||||
```python
|
||||
# 測定スクリプト
|
||||
import tiktoken
|
||||
|
||||
def measure_reduction(nyash_code, ancp_code):
|
||||
enc = tiktoken.get_encoding("cl100k_base")
|
||||
|
||||
nyash_tokens = len(enc.encode(nyash_code))
|
||||
ancp_tokens = len(enc.encode(ancp_code))
|
||||
|
||||
reduction = (1 - ancp_tokens / nyash_tokens) * 100
|
||||
|
||||
print(f"Nyash: {nyash_tokens} tokens")
|
||||
print(f"ANCP: {ancp_tokens} tokens")
|
||||
print(f"Reduction: {reduction:.1f}%")
|
||||
|
||||
return reduction
|
||||
|
||||
# 実例
|
||||
nyash = """
|
||||
box WebServer from HttpBox {
|
||||
init { port, routes }
|
||||
|
||||
birth(port) {
|
||||
me.port = port
|
||||
me.routes = new MapBox()
|
||||
}
|
||||
|
||||
addRoute(path, handler) {
|
||||
me.routes.set(path, handler)
|
||||
return me
|
||||
}
|
||||
}
|
||||
"""
|
||||
|
||||
ancp = "$WebServer@HttpBox{#{port,routes}b(port){m.port=port m.routes=n MapBox()}addRoute(path,handler){m.routes.set(path,handler)r m}}"
|
||||
|
||||
reduction = measure_reduction(nyash, ancp)
|
||||
# 結果: 約65%削減！
|
||||
```
|
||||
|
||||
## 🔧 AIツール統合
|
||||
|
||||
### VSCode + GitHub Copilot
|
||||
```json
|
||||
// .vscode/settings.json
|
||||
{
|
||||
"github.copilot.advanced": {
|
||||
"ancp.hints": {
|
||||
"box": "$",
|
||||
"new": "n",
|
||||
"me": "m"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Custom AI Integration
|
||||
```typescript
|
||||
// AI SDK統合例
|
||||
class AncpAwareAI {
|
||||
async complete(prompt: string, context: string): Promise<string> {
|
||||
// コンテキストをANCPに変換
|
||||
const ancpContext = this.transcoder.encode(context);
|
||||
|
||||
// AI APIコール（トークン数大幅削減）
|
||||
const response = await this.ai.complete({
|
||||
prompt,
|
||||
context: ancpContext,
|
||||
metadata: { format: "ancp:1.0" }
|
||||
});
|
||||
|
||||
// レスポンスをNyashに戻す
|
||||
return this.transcoder.decode(response);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 📚 学習リソース
|
||||
|
||||
### AIモデル向けトレーニングデータ
|
||||
```bash
|
||||
# 並列コーパス生成
|
||||
tools/generate_parallel_corpus.sh
|
||||
|
||||
# 出力
|
||||
corpus/
|
||||
├── nyash/ # 通常のNyashコード
|
||||
├── ancp/ # 対応するANCPコード
|
||||
└── metadata/ # トークン削減率等
|
||||
```
|
||||
|
||||
### プロンプトテンプレート
|
||||
```markdown
|
||||
# 効果的なプロンプト例
|
||||
|
||||
## コード生成
|
||||
"Write a P2P chat application in ANCP notation.
|
||||
Requirements: [要件]
|
||||
Use these patterns: $=box, n=new, m=me"
|
||||
|
||||
## コードレビュー
|
||||
"Review this ANCP code for security issues:
|
||||
```ancp
|
||||
[コード]
|
||||
```
|
||||
Focus on: memory safety, race conditions"
|
||||
|
||||
## リファクタリング
|
||||
"Refactor this ANCP code for better performance:
|
||||
[コード]
|
||||
Maintain the same API but optimize internals"
|
||||
```
|
||||
|
||||
## 🚀 ベストプラクティス
|
||||
|
||||
### DO
|
||||
- ✅ 大規模コードはANCPで渡す
|
||||
- ✅ AI応答もANCPで受け取る
|
||||
- ✅ 記号の意味を最初に説明
|
||||
- ✅ バージョンヘッダーを含める
|
||||
|
||||
### DON'T
|
||||
- ❌ 部分的なANCP使用（混乱の元）
|
||||
- ❌ カスタム記号の追加
|
||||
- ❌ コメントまで圧縮
|
||||
|
||||
## 🎮 実践演習
|
||||
|
||||
### 演習1: 基本変換
|
||||
```nyash
|
||||
// これをANCPに変換
|
||||
box Calculator {
|
||||
init { memory }
|
||||
|
||||
birth() {
|
||||
me.memory = 0
|
||||
}
|
||||
|
||||
add(x, y) {
|
||||
local result = x + y
|
||||
me.memory = result
|
||||
return result
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
<details>
|
||||
<summary>答え</summary>
|
||||
|
||||
```ancp
|
||||
$Calculator{#{memory}b(){m.memory=0}add(x,y){l result=x+y m.memory=result r result}}
|
||||
```
|
||||
</details>
|
||||
|
||||
### 演習2: AI活用
|
||||
```ancp
|
||||
// このANCPコードの問題点をAIに聞く
|
||||
$Server{listen(p){loop(true){l c=accept()process(c)}}}
|
||||
```
|
||||
|
||||
期待する指摘:
|
||||
- エラーハンドリングなし
|
||||
- 接続の並行処理なし
|
||||
- リソースリークの可能性
|
||||
|
||||
## 📈 成功事例
|
||||
|
||||
### 事例1: Nyashコンパイラ開発
|
||||
- 通常: 20,000行 → 40,000 tokens
|
||||
- ANCP: 20,000行 → 15,000 tokens
|
||||
- **結果**: Claude一回のコンテキストで全体を把握！
|
||||
|
||||
### 事例2: バグ修正効率
|
||||
- 従来: 関連コード5ファイルが入らない
|
||||
- ANCP: 10ファイル＋テストコードまで含められる
|
||||
- **結果**: AIが文脈を完全理解し、的確な修正提案
|
||||
|
||||
## 🔮 将来の展望
|
||||
|
||||
### ANCP v2.0
|
||||
- AI専用の追加圧縮
|
||||
- 意味保持型トークン削減
|
||||
- カスタム辞書対応
|
||||
|
||||
### AI統合の深化
|
||||
- IDEでのリアルタイムANCP変換
|
||||
- AIレビューの自動ANCP化
|
||||
- 学習済みANCPモデル
|
||||
|
||||
---
|
||||
|
||||
ANCPは単なる圧縮記法ではなく、AIとNyashをつなぐ架け橋です。
|
||||
この革命的なプロトコルを活用して、AI時代の開発を加速させましょう！
|
||||
301
docs/development/roadmap/phases/phase-12.7/examples.md
Normal file
301
docs/development/roadmap/phases/phase-12.7/examples.md
Normal file
@ -0,0 +1,301 @@
|
||||
# ANCP Examples - 実例で学ぶ圧縮記法
|
||||
|
||||
## 🎯 基本パターン
|
||||
|
||||
### 1. シンプルなBox定義
|
||||
```nyash
|
||||
// Nyash (31文字)
|
||||
box Point {
|
||||
init { x, y }
|
||||
}
|
||||
|
||||
// ANCP (16文字) - 48%削減！
|
||||
$Point{#{x,y}}
|
||||
```
|
||||
|
||||
### 2. メソッド付きBox
|
||||
```nyash
|
||||
// Nyash (118文字)
|
||||
box Calculator {
|
||||
init { result }
|
||||
|
||||
birth() {
|
||||
me.result = 0
|
||||
}
|
||||
|
||||
add(x, y) {
|
||||
me.result = x + y
|
||||
return me.result
|
||||
}
|
||||
}
|
||||
|
||||
// ANCP (59文字) - 50%削減！
|
||||
$Calculator{#{result}b(){m.result=0}add(x,y){m.result=x+y r m.result}}
|
||||
```
|
||||
|
||||
### 3. 継承/デリゲーション
|
||||
```nyash
|
||||
// Nyash (165文字)
|
||||
box Dog from Animal {
|
||||
init { name, breed }
|
||||
|
||||
birth(name, breed) {
|
||||
from Animal.init(name)
|
||||
me.breed = breed
|
||||
}
|
||||
|
||||
bark() {
|
||||
return "Woof! I'm " + me.name
|
||||
}
|
||||
}
|
||||
|
||||
// ANCP (87文字) - 47%削減！
|
||||
$Dog@Animal{#{name,breed}b(name,breed){@Animal.init(name)m.breed=breed}bark(){r"Woof! I'm"+m.name}}
|
||||
```
|
||||
|
||||
## 🚀 実践的な例
|
||||
|
||||
### 4. P2Pノード実装
|
||||
```nyash
|
||||
// Nyash (287文字)
|
||||
box P2PNode from NetworkBox {
|
||||
init { id, peers, messages }
|
||||
|
||||
birth(id) {
|
||||
me.id = id
|
||||
me.peers = new ArrayBox()
|
||||
me.messages = new MapBox()
|
||||
}
|
||||
|
||||
connect(peer) {
|
||||
me.peers.push(peer)
|
||||
peer.addPeer(me)
|
||||
return me
|
||||
}
|
||||
|
||||
broadcast(msg) {
|
||||
local i = 0
|
||||
loop(i < me.peers.length()) {
|
||||
me.peers.get(i).receive(msg)
|
||||
i = i + 1
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// ANCP (156文字) - 46%削減！
|
||||
$P2PNode@NetworkBox{#{id,peers,messages}b(id){m.id=id m.peers=n ArrayBox()m.messages=n MapBox()}connect(peer){m.peers.push(peer)peer.addPeer(m)r m}broadcast(msg){l i=0 L(i<m.peers.length()){m.peers.get(i).receive(msg)i=i+1}}}
|
||||
```
|
||||
|
||||
### 5. 非同期WebServer
|
||||
```nyash
|
||||
// Nyash (342文字)
|
||||
box WebServer from HttpBox {
|
||||
init { port, routes, middleware }
|
||||
|
||||
birth(port) {
|
||||
from HttpBox.init(port)
|
||||
me.routes = new MapBox()
|
||||
me.middleware = new ArrayBox()
|
||||
}
|
||||
|
||||
route(path, handler) {
|
||||
me.routes.set(path, handler)
|
||||
return me
|
||||
}
|
||||
|
||||
use(middleware) {
|
||||
me.middleware.push(middleware)
|
||||
return me
|
||||
}
|
||||
|
||||
async start() {
|
||||
await from HttpBox.listen(me.port)
|
||||
print("Server running on port " + me.port)
|
||||
}
|
||||
}
|
||||
|
||||
// ANCP (183文字) - 46%削減！
|
||||
$WebServer@HttpBox{#{port,routes,middleware}b(port){@HttpBox.init(port)m.routes=n MapBox()m.middleware=n ArrayBox()}route(path,handler){m.routes.set(path,handler)r m}use(middleware){m.middleware.push(middleware)r m}async start(){await @HttpBox.listen(m.port)print("Server running on port"+m.port)}}
|
||||
```
|
||||
|
||||
## 💡 高度なパターン
|
||||
|
||||
### 6. エラーハンドリング
|
||||
```nyash
|
||||
// Nyash (198文字)
|
||||
box SafeCalculator {
|
||||
divide(a, b) {
|
||||
if b == 0 {
|
||||
return new ErrorBox("Division by zero")
|
||||
} else {
|
||||
return new ResultBox(a / b)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// ANCP (93文字) - 53%削減！
|
||||
$SafeCalculator{divide(a,b){?b==0{r n ErrorBox("Division by zero")}:{r n ResultBox(a/b)}}}
|
||||
```
|
||||
|
||||
### 7. ジェネリック風パターン
|
||||
```nyash
|
||||
// Nyash (245文字)
|
||||
box Container {
|
||||
init { items, type }
|
||||
|
||||
birth(type) {
|
||||
me.items = new ArrayBox()
|
||||
me.type = type
|
||||
}
|
||||
|
||||
add(item) {
|
||||
if item.type() == me.type {
|
||||
me.items.push(item)
|
||||
return true
|
||||
}
|
||||
return false
|
||||
}
|
||||
}
|
||||
|
||||
// ANCP (124文字) - 49%削減！
|
||||
$Container{#{items,type}b(type){m.items=n ArrayBox()m.type=type}add(item){?item.type()==m.type{m.items.push(item)r true}r false}}
|
||||
```
|
||||
|
||||
## 🎮 完全なアプリケーション例
|
||||
|
||||
### 8. Todoアプリ（フル実装）
|
||||
```nyash
|
||||
// Nyash (562文字)
|
||||
box TodoApp {
|
||||
init { todos, nextId }
|
||||
|
||||
birth() {
|
||||
me.todos = new ArrayBox()
|
||||
me.nextId = 1
|
||||
}
|
||||
|
||||
addTodo(text) {
|
||||
local todo = new MapBox()
|
||||
todo.set("id", me.nextId)
|
||||
todo.set("text", text)
|
||||
todo.set("done", false)
|
||||
|
||||
me.todos.push(todo)
|
||||
me.nextId = me.nextId + 1
|
||||
|
||||
return todo.get("id")
|
||||
}
|
||||
|
||||
toggleTodo(id) {
|
||||
local i = 0
|
||||
loop(i < me.todos.length()) {
|
||||
local todo = me.todos.get(i)
|
||||
if todo.get("id") == id {
|
||||
todo.set("done", not todo.get("done"))
|
||||
return true
|
||||
}
|
||||
i = i + 1
|
||||
}
|
||||
return false
|
||||
}
|
||||
|
||||
listTodos() {
|
||||
return me.todos
|
||||
}
|
||||
}
|
||||
|
||||
// ANCP (296文字) - 47%削減！
|
||||
$TodoApp{#{todos,nextId}b(){m.todos=n ArrayBox()m.nextId=1}addTodo(text){l todo=n MapBox()todo.set("id",m.nextId)todo.set("text",text)todo.set("done",false)m.todos.push(todo)m.nextId=m.nextId+1 r todo.get("id")}toggleTodo(id){l i=0 L(i<m.todos.length()){l todo=m.todos.get(i)?todo.get("id")==id{todo.set("done",not todo.get("done"))r true}i=i+1}r false}listTodos(){r m.todos}}
|
||||
```
|
||||
|
||||
## 📊 圧縮効果まとめ
|
||||
|
||||
| 例 | Nyash文字数 | ANCP文字数 | 削減率 |
|
||||
|----|------------|-----------|--------|
|
||||
| Point | 31 | 16 | 48% |
|
||||
| Calculator | 118 | 59 | 50% |
|
||||
| Dog | 165 | 87 | 47% |
|
||||
| P2PNode | 287 | 156 | 46% |
|
||||
| WebServer | 342 | 183 | 46% |
|
||||
| SafeCalculator | 198 | 93 | 53% |
|
||||
| Container | 245 | 124 | 49% |
|
||||
| TodoApp | 562 | 296 | 47% |
|
||||
|
||||
**平均削減率: 48.3%**
|
||||
|
||||
## 🔍 パターン分析
|
||||
|
||||
### 最も効果的な変換
|
||||
1. `return` → `r` (83%削減)
|
||||
2. `local` → `l` (80%削減)
|
||||
3. `new` → `n` (67%削減)
|
||||
4. `box` → `$` (75%削減)
|
||||
5. `me` → `m` (50%削減)
|
||||
|
||||
### 圧縮のコツ
|
||||
- 空白を最小限に（セミコロン不要）
|
||||
- 中括弧の直後に内容を書く
|
||||
- 演算子の前後の空白を省略
|
||||
- 文字列連結の空白も省略可能
|
||||
|
||||
## 🎯 練習問題
|
||||
|
||||
### 問題1
|
||||
次のNyashコードをANCPに変換してください：
|
||||
```nyash
|
||||
box User {
|
||||
init { name, email }
|
||||
|
||||
birth(name, email) {
|
||||
me.name = name
|
||||
me.email = email
|
||||
}
|
||||
|
||||
toString() {
|
||||
return me.name + " <" + me.email + ">"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
<details>
|
||||
<summary>答え</summary>
|
||||
|
||||
```ancp
|
||||
$User{#{name,email}b(name,email){m.name=name m.email=email}toString(){r m.name+" <"+m.email+">"}}
|
||||
```
|
||||
</details>
|
||||
|
||||
### 問題2
|
||||
次のANCPコードをNyashに戻してください：
|
||||
```ancp
|
||||
$Stack{#{items}b(){m.items=n ArrayBox()}push(item){m.items.push(item)}pop(){?m.items.length()>0{r m.items.pop()}r null}}
|
||||
```
|
||||
|
||||
<details>
|
||||
<summary>答え</summary>
|
||||
|
||||
```nyash
|
||||
box Stack {
|
||||
init { items }
|
||||
|
||||
birth() {
|
||||
me.items = new ArrayBox()
|
||||
}
|
||||
|
||||
push(item) {
|
||||
me.items.push(item)
|
||||
}
|
||||
|
||||
pop() {
|
||||
if me.items.length() > 0 {
|
||||
return me.items.pop()
|
||||
}
|
||||
return null
|
||||
}
|
||||
}
|
||||
```
|
||||
</details>
|
||||
|
||||
---
|
||||
|
||||
これらの例を参考に、ANCPを使いこなしてAI時代の効率的な開発を実現しましょう！
|
||||
@ -0,0 +1,88 @@
|
||||
Nyashプログラミング言語の文法改革について深い相談です。
|
||||
|
||||
【現在の検討状況】
|
||||
|
||||
1. 予約語を30個→10個に削減済み
|
||||
- box, new, me, public, if, loop, break, return, import, from
|
||||
|
||||
2. コンストラクタ名
|
||||
- 「birth」で統一（Everything is Box哲学を体現）
|
||||
|
||||
3. 変数宣言
|
||||
- := 演算子は却下（localキーワードがあるため明示的）
|
||||
- local x = 42 の形式を維持
|
||||
|
||||
4. デリゲーション
|
||||
- fromキーワード維持（box Child from Parent）
|
||||
- 親メソッド呼び出しは Parent::method()
|
||||
|
||||
5. フィールド可視性
|
||||
- デフォルト非公開（privateキーワード削除）
|
||||
- publicで明示的に公開
|
||||
|
||||
6. セミコロン
|
||||
- 基本的に不要（Python風）
|
||||
- 1行複数文の場合のみ使用可
|
||||
|
||||
【新たな提案：fields{}ブロック】
|
||||
|
||||
現在の書き方：
|
||||
box Counter {
|
||||
public { name, count }
|
||||
private { cache }
|
||||
|
||||
birth() { }
|
||||
}
|
||||
|
||||
提案されたfields{}ブロック：
|
||||
box Counter {
|
||||
fields {
|
||||
IntegerBox count
|
||||
public StringBox name
|
||||
MapBox cache
|
||||
}
|
||||
|
||||
birth(name) {
|
||||
me.name = name
|
||||
me.count = 0
|
||||
}
|
||||
}
|
||||
|
||||
【議論のポイント】
|
||||
|
||||
1. fields{}ブロック内だけセミコロンを使うと違和感がある
|
||||
- 全体でセミコロンなしなのに、fieldsだけセミコロンは一貫性がない
|
||||
|
||||
2. 他の記法案：
|
||||
- has{} ブロック（「箱が持つもの」）
|
||||
- contains{} （「箱に含まれるもの」）
|
||||
- inside{} （「箱の中身」）
|
||||
|
||||
【質問】
|
||||
|
||||
1. fields{}ブロック内のセミコロン問題をどう解決すべきか？
|
||||
- セミコロンなしで統一？
|
||||
- 改行で区切り？
|
||||
- 別の区切り方？
|
||||
|
||||
2. フィールド宣言の最良の記法は？
|
||||
- fields{} が最適か？
|
||||
- 型名を先に書く（IntegerBox count）か後に書く（count: IntegerBox）か？
|
||||
- publicの位置は？
|
||||
|
||||
3. Everything is Box哲学との整合性
|
||||
- 「箱の中身を宣言する」という意味でfields{}は適切か？
|
||||
- もっと箱らしい表現はあるか？
|
||||
|
||||
4. 全体の文法一貫性
|
||||
- セミコロンなし統一でいくべきか？
|
||||
- フィールド宣言だけ特別扱いすべきか？
|
||||
|
||||
【理想】
|
||||
- 明示的（何が起きているか一目瞭然）
|
||||
- 初学者フレンドリー
|
||||
- Everything is Box哲学に忠実
|
||||
- 書いていて楽しい文法
|
||||
|
||||
プログラミング言語設計の専門的視点から、深い分析と提案をお願いします。
|
||||
時間制限なしでじっくり考えてください。
|
||||
@ -0,0 +1,235 @@
|
||||
================================================================================
|
||||
Nyash文法改革 - 深い検討結果まとめ
|
||||
2025-09-03
|
||||
================================================================================
|
||||
|
||||
【検討参加者】
|
||||
- Claude (私)
|
||||
- Gemini先生
|
||||
- Codex先生
|
||||
- ユーザー（にゃ）
|
||||
|
||||
================================================================================
|
||||
1. 現状の問題点
|
||||
================================================================================
|
||||
|
||||
- 予約語が約30個と多すぎる
|
||||
- CLAUDE.mdとLANGUAGE_REFERENCE_2025.mdで記述が矛盾
|
||||
- CLAUDE.md: birth > pack > init > Box名形式
|
||||
- LANGUAGE_REFERENCE_2025.md: init構文に統一
|
||||
- 「Everything is Box」哲学に反する特殊ケースが多い
|
||||
- 文法が複雑で初学者には分かりにくい
|
||||
|
||||
================================================================================
|
||||
2. Gemini先生の提案
|
||||
================================================================================
|
||||
|
||||
【核心的な提案】
|
||||
1. birthコンストラクタ採用（Everything is Box哲学に最適）
|
||||
2. 予約語10個に削減
|
||||
3. デリゲーションは手動（fromキーワード廃止）→ しかしユーザーから問題指摘
|
||||
4. 論理演算子は記号化（!, &&, ||）
|
||||
5. エラーはResult Box（Ok/Err）で統一
|
||||
|
||||
【予約語リスト（Gemini案）】
|
||||
- box, new, me, public, if, loop, break, return, let, import
|
||||
|
||||
【問題点】
|
||||
- fromキーワードの重要な役割を見落としていた
|
||||
1. デリゲーション宣言: box Child from Parent
|
||||
2. 親メソッド呼び出し: from Parent.method()
|
||||
|
||||
================================================================================
|
||||
3. Codex先生の革新的解決策
|
||||
================================================================================
|
||||
|
||||
【fromキーワードの扱い】
|
||||
- fromは残す（文脈的キーワードとして）
|
||||
- 親メソッド呼び出しは :: 記法を使用
|
||||
- Parent::method() ← 明確で美しい！
|
||||
- 単一親の場合の糖衣構文: from method()
|
||||
|
||||
【変数宣言の革新】
|
||||
- Go風の := 演算子を導入
|
||||
- x := 10 // 新規宣言
|
||||
- x = 20 // 既存変数への代入
|
||||
- letはソフトキーワード（オプション）
|
||||
- let x = 10 は x := 10 の糖衣構文
|
||||
|
||||
【その他の最適化】
|
||||
- overrideを@override属性に変更（予約語削減）
|
||||
- privateキーワード削除（デフォルト非公開）
|
||||
|
||||
================================================================================
|
||||
4. 最終的な文法提案
|
||||
================================================================================
|
||||
|
||||
【予約語（10個のみ！）】
|
||||
1. box - Box定義
|
||||
2. new - インスタンス生成
|
||||
3. me - 自己参照
|
||||
4. public - 公開指定（デフォルトは非公開）
|
||||
5. if - 条件分岐
|
||||
6. loop - ループ
|
||||
7. break - ループ脱出
|
||||
8. return - 戻り値
|
||||
9. import - モジュール読み込み
|
||||
10. from - デリゲーション宣言
|
||||
|
||||
【コンストラクタ】
|
||||
- birthで統一（Everything is Box哲学を体現）
|
||||
- packはビルトインBox継承専用（将来的に見直し可能）
|
||||
|
||||
【変数宣言】
|
||||
x := 10 // 新規宣言（推奨）
|
||||
let x = 10 // 新規宣言（糖衣構文）
|
||||
x = 20 // 既存変数への代入
|
||||
|
||||
【デリゲーション】
|
||||
box Child from Parent {
|
||||
@override
|
||||
public method() {
|
||||
Parent::method() // 親メソッド呼び出し
|
||||
// または
|
||||
from method() // 単一親の場合の糖衣構文
|
||||
}
|
||||
}
|
||||
|
||||
【可視性】
|
||||
box SecureBox {
|
||||
// デフォルトで非公開
|
||||
secret: str
|
||||
internal_state: i64
|
||||
|
||||
// 明示的に公開
|
||||
public id: str
|
||||
|
||||
// メソッドも同じ
|
||||
process() { } // 非公開
|
||||
public api() { } // 公開
|
||||
}
|
||||
|
||||
【論理演算子】
|
||||
- not → !
|
||||
- and → &&
|
||||
- or → ||
|
||||
|
||||
【エラーハンドリング】
|
||||
- Result[T, E]型で統一
|
||||
- Ok(value) / Err(error)
|
||||
- ? 演算子でエラー伝播
|
||||
|
||||
================================================================================
|
||||
5. 実装例
|
||||
================================================================================
|
||||
|
||||
【基本的なBox定義】
|
||||
box Calculator from BaseCalculator {
|
||||
// フィールド（デフォルト非公開）
|
||||
count := 0
|
||||
cache: Map[str, f64]
|
||||
|
||||
// 公開フィールド
|
||||
public name: str
|
||||
|
||||
// コンストラクタ
|
||||
public birth(name) {
|
||||
me.name = name
|
||||
me.count = 0
|
||||
me.cache = new Map[str, f64]()
|
||||
}
|
||||
|
||||
// 公開メソッド
|
||||
@override
|
||||
public calculate(x, y) {
|
||||
me.count = me.count + 1
|
||||
|
||||
// 親メソッド呼び出し
|
||||
result := BaseCalculator::calculate(x, y)?
|
||||
|
||||
// キャッシュに保存
|
||||
key := x + "," + y
|
||||
me.cache.set(key, result)
|
||||
|
||||
return new Ok(result * 2)
|
||||
}
|
||||
|
||||
// 非公開メソッド
|
||||
clear_cache() {
|
||||
me.cache.clear()
|
||||
}
|
||||
}
|
||||
|
||||
【使用例】
|
||||
calc := new Calculator("MyCalc")
|
||||
result := calc.calculate(10, 20)?
|
||||
print(result) // 60
|
||||
|
||||
================================================================================
|
||||
6. 移行ガイド
|
||||
================================================================================
|
||||
|
||||
【予約語の変更】
|
||||
- private → 削除（デフォルト非公開）
|
||||
- var → 削除（:= または let を使用）
|
||||
- static → 検討中
|
||||
- interface → 検討中
|
||||
- function → 削除（メソッドのみ）
|
||||
- try/catch/throw → Result型 + ? 演算子
|
||||
- true/false → 検討中（予約語から外す可能性）
|
||||
- not/and/or → !/&&/||
|
||||
|
||||
【構文の変更】
|
||||
- init() → birth()
|
||||
- from Parent.method() → Parent::method()
|
||||
- override → @override
|
||||
- private field → field（デフォルト）
|
||||
|
||||
================================================================================
|
||||
7. 未解決の課題
|
||||
================================================================================
|
||||
|
||||
1. staticキーワードの扱い
|
||||
- Static Box Mainパターンをどう表現するか
|
||||
|
||||
2. interfaceキーワードの扱い
|
||||
- ダックタイピングで十分か？
|
||||
- 構造的部分型で代替可能か？
|
||||
|
||||
3. true/falseの扱い
|
||||
- 予約語から外してBoolBoxの定数にするか？
|
||||
|
||||
4. asyncの扱い
|
||||
- Task[T]型 + .await()メソッドで十分か？
|
||||
|
||||
5. 型アノテーション
|
||||
- : Type 形式で統一でOKか？
|
||||
|
||||
6. ジェネリクス
|
||||
- Box[T, E] 形式で統一でOKか？
|
||||
|
||||
================================================================================
|
||||
8. 次のステップ
|
||||
================================================================================
|
||||
|
||||
1. この提案をベースに具体的な文法仕様書を作成
|
||||
2. パーサーへの影響を評価
|
||||
3. 既存コードの移行計画を立案
|
||||
4. スモークテストの更新
|
||||
5. ドキュメント（CLAUDE.md, LANGUAGE_REFERENCE_2025.md）の統一
|
||||
|
||||
================================================================================
|
||||
9. 結論
|
||||
================================================================================
|
||||
|
||||
予約語を10個に削減し、「Everything is Box」哲学を徹底することで、
|
||||
シンプルで強力、かつ初学者にも分かりやすい言語を実現できる。
|
||||
|
||||
特に重要なのは：
|
||||
- birthコンストラクタ（哲学の体現）
|
||||
- fromキーワードの維持（実用性）
|
||||
- := 演算子の導入（明確な宣言）
|
||||
- デフォルト非公開（安全性）
|
||||
- :: による親メソッド呼び出し（明確性）
|
||||
|
||||
これらにより、Nyashは本当に「世界一美しい箱」になる。
|
||||
@ -0,0 +1,92 @@
|
||||
================================================================================
|
||||
Nyash文法改革 - 実装向け要約
|
||||
2025-09-03
|
||||
================================================================================
|
||||
|
||||
【最重要決定事項】
|
||||
|
||||
1. 予約語は10個のみ
|
||||
- box, new, me, public, if, loop, break, return, import, from
|
||||
|
||||
2. コンストラクタ名は「birth」で統一
|
||||
- Everything is Box哲学を体現
|
||||
- packはビルトインBox継承時のみ（将来廃止検討）
|
||||
|
||||
3. 変数宣言は := 演算子を導入
|
||||
- x := 10 // 新規宣言
|
||||
- x = 20 // 既存変数への代入
|
||||
- let x = 10 // オプション（糖衣構文）
|
||||
|
||||
4. デリゲーションと親メソッド呼び出し
|
||||
- box Child from Parent { } // fromは残す
|
||||
- Parent::method() // 親メソッド呼び出し（推奨）
|
||||
- from method() // 単一親の場合の糖衣構文
|
||||
|
||||
5. デフォルト非公開
|
||||
- privateキーワード削除
|
||||
- publicを付けたものだけ公開
|
||||
|
||||
================================================================================
|
||||
【具体例】
|
||||
================================================================================
|
||||
|
||||
box Counter from BaseCounter {
|
||||
// フィールド（デフォルト非公開）
|
||||
count := 0
|
||||
|
||||
// 公開フィールド
|
||||
public name: str
|
||||
|
||||
// コンストラクタ（birthで統一）
|
||||
public birth(name) {
|
||||
me.name = name
|
||||
BaseCounter::birth() // 親のbirth呼び出し
|
||||
}
|
||||
|
||||
// メソッド（@overrideは属性）
|
||||
@override
|
||||
public increment() {
|
||||
me.count = me.count + 1
|
||||
BaseCounter::increment() // 親メソッド呼び出し
|
||||
return me.count
|
||||
}
|
||||
}
|
||||
|
||||
// 使用
|
||||
counter := new Counter("MyCounter")
|
||||
counter.increment()
|
||||
|
||||
================================================================================
|
||||
【移行チェックリスト】
|
||||
================================================================================
|
||||
|
||||
□ init → birth に変更
|
||||
□ private削除（デフォルト非公開）
|
||||
□ var x = → x := に変更
|
||||
□ from Parent.method() → Parent::method()
|
||||
□ override → @override
|
||||
□ and/or/not → &&/||/!
|
||||
□ try/catch → Result型 + ?演算子
|
||||
|
||||
================================================================================
|
||||
【パーサー実装への影響】
|
||||
================================================================================
|
||||
|
||||
1. 予約語リストを10個に削減
|
||||
2. := 演算子のサポート追加
|
||||
3. :: 演算子の拡張（親メソッド呼び出し対応）
|
||||
4. @属性のサポート追加
|
||||
5. privateキーワードの削除
|
||||
6. 文脈的from解釈の実装
|
||||
|
||||
================================================================================
|
||||
【次のアクション】
|
||||
================================================================================
|
||||
|
||||
1. LANGUAGE_REFERENCE_2025.mdの更新
|
||||
2. CLAUDE.mdの更新（birthを最優先に）
|
||||
3. パーサーの予約語リスト修正
|
||||
4. テストケースの更新
|
||||
5. 既存サンプルコードの移行
|
||||
|
||||
================================================================================
|
||||
@ -0,0 +1,402 @@
|
||||
# ANCP Implementation Plan
|
||||
|
||||
## 🎯 実装戦略：段階的アプローチ
|
||||
|
||||
### 基本方針
|
||||
1. **最小実装から開始**: 20語の固定辞書でMVP
|
||||
2. **段階的拡張**: 機能を少しずつ追加
|
||||
3. **早期統合**: スモークテストと早期に統合
|
||||
4. **継続的検証**: 各段階で往復テスト実施
|
||||
|
||||
## 📅 Week 1: 基礎実装
|
||||
|
||||
### Day 1-2: プロジェクトセットアップ
|
||||
```toml
|
||||
# Cargo.toml に追加
|
||||
[features]
|
||||
ancp = []
|
||||
|
||||
[dependencies]
|
||||
phf = "0.11" # 静的マップ用
|
||||
tiktoken-rs = "0.5" # トークン計測用（optional）
|
||||
```
|
||||
|
||||
### Day 3-4: 基本Transcoder実装
|
||||
```rust
|
||||
// src/ancp/mod.rs
|
||||
pub mod transcoder;
|
||||
pub mod mappings;
|
||||
pub mod error;
|
||||
|
||||
// src/ancp/transcoder.rs
|
||||
use phf::phf_map;
|
||||
|
||||
static NYASH_TO_ANCP: phf::Map<&'static str, &'static str> = phf_map! {
|
||||
"box" => "$",
|
||||
"new" => "n",
|
||||
"me" => "m",
|
||||
"local" => "l",
|
||||
"return" => "r",
|
||||
// ... 初期20語
|
||||
};
|
||||
|
||||
pub struct BasicTranscoder;
|
||||
|
||||
impl BasicTranscoder {
|
||||
pub fn encode(&self, input: &str) -> String {
|
||||
let mut result = String::with_capacity(input.len());
|
||||
let tokens = tokenize_simple(input);
|
||||
|
||||
for token in tokens {
|
||||
match NYASH_TO_ANCP.get(token.text) {
|
||||
Some(ancp) => result.push_str(ancp),
|
||||
None => result.push_str(token.text),
|
||||
}
|
||||
result.push_str(&token.trailing_space);
|
||||
}
|
||||
|
||||
result
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Day 5-7: 基本往復テスト
|
||||
```rust
|
||||
// tests/ancp_roundtrip.rs
|
||||
#[test]
|
||||
fn test_basic_roundtrip() {
|
||||
let cases = vec![
|
||||
"box Test { }",
|
||||
"new StringBox()",
|
||||
"me.field = 42",
|
||||
"local x = 10",
|
||||
"return result",
|
||||
];
|
||||
|
||||
let transcoder = BasicTranscoder::new();
|
||||
|
||||
for case in cases {
|
||||
let encoded = transcoder.encode(case);
|
||||
let decoded = transcoder.decode(&encoded);
|
||||
assert_eq!(case, decoded, "Failed for: {}", case);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 📅 Week 2: スマート変換
|
||||
|
||||
### Day 8-9: コンテキスト認識パーサー
|
||||
```rust
|
||||
// src/ancp/context_parser.rs
|
||||
pub struct ContextAwareTranscoder {
|
||||
basic: BasicTranscoder,
|
||||
}
|
||||
|
||||
impl ContextAwareTranscoder {
|
||||
pub fn encode(&self, input: &str) -> String {
|
||||
let mut result = String::new();
|
||||
let mut in_string = false;
|
||||
let mut in_comment = false;
|
||||
|
||||
// 文字列・コメント内は変換しない
|
||||
for (i, ch) in input.chars().enumerate() {
|
||||
match ch {
|
||||
'"' if !in_comment => in_string = !in_string,
|
||||
'/' if !in_string && peek_next(input, i) == Some('/') => {
|
||||
in_comment = true;
|
||||
},
|
||||
'\n' => in_comment = false,
|
||||
_ => {}
|
||||
}
|
||||
|
||||
// コンテキストに応じて処理
|
||||
if !in_string && !in_comment {
|
||||
// トークン変換
|
||||
} else {
|
||||
// そのまま出力
|
||||
}
|
||||
}
|
||||
|
||||
result
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Day 10-11: Lexer統合
|
||||
```rust
|
||||
// src/parser/lexer.rs に追加
|
||||
impl Lexer {
|
||||
pub fn with_ancp_support(input: &str) -> Self {
|
||||
if input.starts_with(";ancp:") {
|
||||
// ANCPモードで初期化
|
||||
Self::new_ancp_mode(input)
|
||||
} else {
|
||||
Self::new(input)
|
||||
}
|
||||
}
|
||||
|
||||
fn new_ancp_mode(input: &str) -> Self {
|
||||
// ANCP → Nyash変換してからレキシング
|
||||
let transcoder = get_transcoder();
|
||||
let nyash_code = transcoder.decode(input).unwrap();
|
||||
Self::new(&nyash_code)
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Day 12-14: エラー位置マッピング
|
||||
```rust
|
||||
// src/ancp/source_map.rs
|
||||
pub struct SourceMap {
|
||||
mappings: Vec<Mapping>,
|
||||
}
|
||||
|
||||
impl SourceMap {
|
||||
pub fn translate_position(&self, ancp_pos: Position) -> Position {
|
||||
// ANCP位置 → Nyash位置への変換
|
||||
self.mappings
|
||||
.binary_search_by_key(&ancp_pos, |m| m.ancp_pos)
|
||||
.map(|i| self.mappings[i].nyash_pos)
|
||||
.unwrap_or(ancp_pos)
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 📅 Week 3: ツール実装
|
||||
|
||||
### Day 15-16: CLIツール
|
||||
```rust
|
||||
// src/bin/nyash2ancp.rs
|
||||
use clap::Parser;
|
||||
|
||||
#[derive(Parser)]
|
||||
struct Args {
|
||||
#[clap(short, long)]
|
||||
input: PathBuf,
|
||||
|
||||
#[clap(short, long)]
|
||||
output: Option<PathBuf>,
|
||||
|
||||
#[clap(long)]
|
||||
measure_tokens: bool,
|
||||
}
|
||||
|
||||
fn main() -> Result<()> {
|
||||
let args = Args::parse();
|
||||
let content = fs::read_to_string(&args.input)?;
|
||||
|
||||
let transcoder = AncpTranscoder::new();
|
||||
let encoded = transcoder.encode(&content)?;
|
||||
|
||||
if args.measure_tokens {
|
||||
let reduction = measure_token_reduction(&content, &encoded);
|
||||
eprintln!("Token reduction: {:.1}%", reduction * 100.0);
|
||||
}
|
||||
|
||||
match args.output {
|
||||
Some(path) => fs::write(path, encoded)?,
|
||||
None => print!("{}", encoded),
|
||||
}
|
||||
|
||||
Ok(())
|
||||
}
|
||||
```
|
||||
|
||||
### Day 17-18: スモークテスト統合
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# tools/test_ancp_roundtrip.sh
|
||||
|
||||
test_file=$1
|
||||
expected_pattern=$2
|
||||
|
||||
# 1. 通常実行
|
||||
normal_output=$(./target/release/nyash "$test_file" 2>&1)
|
||||
|
||||
# 2. ANCP変換
|
||||
ancp_file="${test_file%.nyash}.ancp"
|
||||
./target/release/nyash2ancp -i "$test_file" -o "$ancp_file"
|
||||
|
||||
# 3. ANCP実行
|
||||
ancp_output=$(./target/release/nyash "$ancp_file" 2>&1)
|
||||
|
||||
# 4. 出力比較
|
||||
if [ "$normal_output" != "$ancp_output" ]; then
|
||||
echo "ERROR: Output mismatch for $test_file"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# 5. パターン検証（既存のスモークテスト方式）
|
||||
echo "$ancp_output" | grep -q "$expected_pattern"
|
||||
```
|
||||
|
||||
### Day 19-21: VSCode拡張（基礎）
|
||||
```typescript
|
||||
// vscode-extension/src/extension.ts
|
||||
import * as vscode from 'vscode';
|
||||
|
||||
export function activate(context: vscode.ExtensionContext) {
|
||||
// ホバープロバイダー
|
||||
const hoverProvider = vscode.languages.registerHoverProvider(
|
||||
'ancp',
|
||||
{
|
||||
provideHover(document, position) {
|
||||
const word = document.getText(
|
||||
document.getWordRangeAtPosition(position)
|
||||
);
|
||||
|
||||
const original = ancpToNyash(word);
|
||||
if (original !== word) {
|
||||
return new vscode.Hover(
|
||||
`ANCP: \`${word}\` → Nyash: \`${original}\``
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
);
|
||||
|
||||
context.subscriptions.push(hoverProvider);
|
||||
}
|
||||
```
|
||||
|
||||
## 📅 Week 4: 最適化と統合
|
||||
|
||||
### Day 22-23: tiktoken実測と最適化
|
||||
```python
|
||||
# tools/measure_ancp_efficiency.py
|
||||
import tiktoken
|
||||
import json
|
||||
|
||||
enc = tiktoken.get_encoding("cl100k_base")
|
||||
|
||||
def measure_file(nyash_path, ancp_path):
|
||||
with open(nyash_path) as f:
|
||||
nyash_code = f.read()
|
||||
with open(ancp_path) as f:
|
||||
ancp_code = f.read()
|
||||
|
||||
nyash_tokens = len(enc.encode(nyash_code))
|
||||
ancp_tokens = len(enc.encode(ancp_code))
|
||||
|
||||
return {
|
||||
"file": nyash_path,
|
||||
"nyash_tokens": nyash_tokens,
|
||||
"ancp_tokens": ancp_tokens,
|
||||
"reduction": 1 - (ancp_tokens / nyash_tokens),
|
||||
"nyash_chars": len(nyash_code),
|
||||
"ancp_chars": len(ancp_code),
|
||||
}
|
||||
|
||||
# 全サンプルファイルで測定
|
||||
results = []
|
||||
for nyash_file in glob.glob("examples/*.nyash"):
|
||||
ancp_file = nyash_file.replace(".nyash", ".ancp")
|
||||
results.append(measure_file(nyash_file, ancp_file))
|
||||
|
||||
# 統計出力
|
||||
avg_reduction = sum(r["reduction"] for r in results) / len(results)
|
||||
print(f"Average token reduction: {avg_reduction:.1%}")
|
||||
```
|
||||
|
||||
### Day 24-25: CI/CD統合
|
||||
```yaml
|
||||
# .github/workflows/ancp.yml
|
||||
name: ANCP Tests
|
||||
|
||||
on: [push, pull_request]
|
||||
|
||||
jobs:
|
||||
ancp-roundtrip:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
- name: Build with ANCP
|
||||
run: cargo build --release --features ancp
|
||||
|
||||
- name: Run roundtrip tests
|
||||
run: |
|
||||
for f in examples/*.nyash; do
|
||||
echo "Testing: $f"
|
||||
./tools/test_ancp_roundtrip.sh "$f"
|
||||
done
|
||||
|
||||
- name: Measure efficiency
|
||||
run: |
|
||||
python3 tools/measure_ancp_efficiency.py > ancp_report.json
|
||||
|
||||
- name: Upload report
|
||||
uses: actions/upload-artifact@v3
|
||||
with:
|
||||
name: ancp-efficiency-report
|
||||
path: ancp_report.json
|
||||
```
|
||||
|
||||
### Day 26-28: ドキュメント・最終調整
|
||||
- ユーザーガイド作成
|
||||
- API ドキュメント生成
|
||||
- パフォーマンスチューニング
|
||||
- 最終テスト
|
||||
|
||||
## 🎯 成功指標
|
||||
|
||||
### Week 1終了時
|
||||
- [ ] 基本20語で往復変換成功
|
||||
- [ ] 単純なNyashプログラムが動作
|
||||
|
||||
### Week 2終了時
|
||||
- [ ] コンテキスト認識変換
|
||||
- [ ] Lexer統合完了
|
||||
- [ ] エラー位置の正確なマッピング
|
||||
|
||||
### Week 3終了時
|
||||
- [ ] CLI ツール完成
|
||||
- [ ] スモークテスト統合
|
||||
- [ ] VSCode基本機能
|
||||
|
||||
### Week 4終了時
|
||||
- [ ] トークン削減率50%以上達成
|
||||
- [ ] 全サンプルで往復テスト成功
|
||||
- [ ] CI/CD完全統合
|
||||
- [ ] ドキュメント完成
|
||||
|
||||
## 🚧 リスクと対策
|
||||
|
||||
### 技術的リスク
|
||||
1. **パフォーマンス劣化**
|
||||
- 対策: 段階的実装で早期発見
|
||||
- 対策: プロファイリング継続実施
|
||||
|
||||
2. **互換性問題**
|
||||
- 対策: 既存テストスイートで検証
|
||||
- 対策: feature flagで段階的有効化
|
||||
|
||||
### 運用リスク
|
||||
1. **採用障壁**
|
||||
- 対策: 分かりやすいドキュメント
|
||||
- 対策: 移行ツール提供
|
||||
|
||||
2. **メンテナンス負荷**
|
||||
- 対策: 自動テスト充実
|
||||
- 対策: CI/CDで品質保証
|
||||
|
||||
## 📝 チェックリスト
|
||||
|
||||
### 実装前
|
||||
- [ ] tiktoken実測による記号選定完了
|
||||
- [ ] 関係者への影響確認
|
||||
- [ ] feature flag設計確認
|
||||
|
||||
### 実装中
|
||||
- [ ] 日次で往復テスト実施
|
||||
- [ ] パフォーマンス計測継続
|
||||
- [ ] ドキュメント同時更新
|
||||
|
||||
### 実装後
|
||||
- [ ] 全スモークテスト合格
|
||||
- [ ] トークン削減率目標達成
|
||||
- [ ] ユーザーガイド完成
|
||||
|
||||
---
|
||||
|
||||
この計画に従って実装を進めることで、4週間でANCPを完成させ、AIとの協働開発を革命的に改善します！
|
||||
293
docs/development/roadmap/phases/phase-12.7/technical-spec.md
Normal file
293
docs/development/roadmap/phases/phase-12.7/technical-spec.md
Normal file
@ -0,0 +1,293 @@
|
||||
# ANCP Technical Specification v1.0
|
||||
|
||||
## 1. プロトコル概要
|
||||
|
||||
### 1.1 設計原則
|
||||
- **可逆性**: 100%の双方向変換保証
|
||||
- **効率性**: 50-70%のトークン削減
|
||||
- **可読性**: 人間も慣れれば読み書き可能
|
||||
- **拡張性**: バージョニングによる将来対応
|
||||
|
||||
### 1.2 プロトコルヘッダー
|
||||
```
|
||||
;ancp:1.0 nyash:0.5.0;
|
||||
```
|
||||
- `ancp:1.0`: ANCPプロトコルバージョン
|
||||
- `nyash:0.5.0`: 対応Nyashバージョン
|
||||
|
||||
## 2. 記号マッピング仕様
|
||||
|
||||
### 2.1 予約語マッピング（優先度順）
|
||||
|
||||
#### Tier 1: 超高頻度（1文字）
|
||||
| Nyash | ANCP | 頻度 | tiktoken削減 |
|
||||
|-------|------|------|--------------|
|
||||
| me | m | 極高 | 2→1 (50%) |
|
||||
| new | n | 高 | 3→1 (67%) |
|
||||
| return | r | 高 | 6→1 (83%) |
|
||||
| local | l | 高 | 5→1 (80%) |
|
||||
|
||||
#### Tier 2: 高頻度（1文字特殊）
|
||||
| Nyash | ANCP | 理由 |
|
||||
|-------|------|------|
|
||||
| box | $ | 金庫のメタファー |
|
||||
| from | @ | 接続を表現 |
|
||||
| init | # | 初期化のハッシュ |
|
||||
| if | ? | 疑問・条件 |
|
||||
| else | : | 条件の区切り |
|
||||
|
||||
#### Tier 3: 中頻度（1-2文字）
|
||||
| Nyash | ANCP | 理由 |
|
||||
|-------|------|------|
|
||||
| static | S | 大文字で静的を表現 |
|
||||
| loop | L | ループのL |
|
||||
| birth | b | 誕生のb |
|
||||
| override | O | 上書きのO |
|
||||
| pack | p | パックのp |
|
||||
|
||||
### 2.2 演算子・記号の扱い
|
||||
- 算術演算子（+, -, *, /）: そのまま
|
||||
- 比較演算子（==, !=, <, >）: そのまま
|
||||
- 論理演算子（and, or, not）: 検討中
|
||||
- `and` → `&`
|
||||
- `or` → `|`
|
||||
- `not` → `!`
|
||||
|
||||
### 2.3 複合パターン
|
||||
```nyash
|
||||
// 元のコード
|
||||
box Cat from Animal {
|
||||
init { name, age }
|
||||
}
|
||||
|
||||
// ANCP変換後
|
||||
$Cat@Animal{#{name,age}}
|
||||
```
|
||||
|
||||
## 3. パース規則
|
||||
|
||||
### 3.1 トークン境界
|
||||
- 記号の前後に空白は不要（`$Cat`でOK）
|
||||
- 識別子の区切りは既存ルール継承
|
||||
- 文字列・コメント内は変換しない
|
||||
|
||||
### 3.2 優先順位
|
||||
1. 文字列リテラル内: 変換なし
|
||||
2. コメント内: 変換なし
|
||||
3. 識別子の一部: 変換なし（`method_name`の`me`は変換しない）
|
||||
4. 独立トークン: 変換対象
|
||||
|
||||
### 3.3 コンテキスト認識
|
||||
```rust
|
||||
enum TokenContext {
|
||||
Normal, // 通常（変換対象）
|
||||
StringLiteral, // 文字列内
|
||||
Comment, // コメント内
|
||||
Identifier, // 識別子の一部
|
||||
}
|
||||
```
|
||||
|
||||
## 4. 実装仕様
|
||||
|
||||
### 4.1 Transcoder API
|
||||
```rust
|
||||
pub trait AncpTranscoder {
|
||||
// 基本変換
|
||||
fn encode(&self, nyash: &str) -> Result<String, AncpError>;
|
||||
fn decode(&self, ancp: &str) -> Result<String, AncpError>;
|
||||
|
||||
// ストリーミング変換
|
||||
fn encode_stream(&self, input: impl Read) -> impl Read;
|
||||
fn decode_stream(&self, input: impl Read) -> impl Read;
|
||||
|
||||
// 位置情報保持
|
||||
fn encode_with_map(&self, nyash: &str) -> Result<(String, SourceMap), AncpError>;
|
||||
fn decode_with_map(&self, ancp: &str) -> Result<(String, SourceMap), AncpError>;
|
||||
}
|
||||
```
|
||||
|
||||
### 4.2 SourceMap仕様
|
||||
```rust
|
||||
pub struct SourceMap {
|
||||
mappings: Vec<Mapping>,
|
||||
}
|
||||
|
||||
pub struct Mapping {
|
||||
// 元の位置
|
||||
original_line: u32,
|
||||
original_column: u32,
|
||||
original_token: String,
|
||||
|
||||
// 変換後の位置
|
||||
generated_line: u32,
|
||||
generated_column: u32,
|
||||
generated_token: String,
|
||||
}
|
||||
```
|
||||
|
||||
### 4.3 エラーハンドリング
|
||||
```rust
|
||||
pub enum AncpError {
|
||||
// 構文エラー
|
||||
InvalidSyntax { position: Position, expected: String },
|
||||
|
||||
// バージョン非互換
|
||||
VersionMismatch { required: Version, found: Version },
|
||||
|
||||
// 変換不可能
|
||||
UnsupportedConstruct { construct: String, reason: String },
|
||||
}
|
||||
```
|
||||
|
||||
## 5. 統合仕様
|
||||
|
||||
### 5.1 Lexer統合
|
||||
```rust
|
||||
// Lexerに追加
|
||||
pub enum InputDialect {
|
||||
Nyash,
|
||||
Ancp(Version),
|
||||
}
|
||||
|
||||
impl Lexer {
|
||||
pub fn new_with_dialect(input: &str, dialect: InputDialect) -> Self {
|
||||
// ヘッダー検出で自動判定も可能
|
||||
let dialect = detect_dialect(input).unwrap_or(dialect);
|
||||
// ...
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 5.2 CLI統合
|
||||
```bash
|
||||
# 変換コマンド
|
||||
nyash --to-ancp input.nyash > output.ancp
|
||||
nyash --from-ancp input.ancp > output.nyash
|
||||
|
||||
# 直接実行
|
||||
nyash --dialect=ancp script.ancp
|
||||
|
||||
# フォーマット表示
|
||||
nyash --view=ancp script.nyash # Nyashファイルをancp形式で表示
|
||||
nyash --view=hybrid script.ancp # 並列表示
|
||||
```
|
||||
|
||||
### 5.3 VSCode統合
|
||||
```typescript
|
||||
// 言語サーバープロトコル拡張
|
||||
interface AncpHoverInfo {
|
||||
original: string; // Nyash形式
|
||||
compressed: string; // ANCP形式
|
||||
savings: number; // 削減率
|
||||
}
|
||||
|
||||
// リアルタイム変換
|
||||
interface AncpLens {
|
||||
showOriginal: boolean;
|
||||
showCompressed: boolean;
|
||||
showSavings: boolean;
|
||||
}
|
||||
```
|
||||
|
||||
## 6. テスト仕様
|
||||
|
||||
### 6.1 往復テスト
|
||||
```rust
|
||||
#[test]
|
||||
fn roundtrip_all_constructs() {
|
||||
let test_cases = vec![
|
||||
// 基本構造
|
||||
"box Test { }",
|
||||
"box Child from Parent { }",
|
||||
|
||||
// メソッド定義
|
||||
"birth() { me.x = 1 }",
|
||||
"override method() { from Parent.method() }",
|
||||
|
||||
// 制御構造
|
||||
"if x == 1 { } else { }",
|
||||
"loop(i < 10) { i = i + 1 }",
|
||||
|
||||
// 複雑な例
|
||||
include_str!("../examples/complex.nyash"),
|
||||
];
|
||||
|
||||
for case in test_cases {
|
||||
let encoded = transcoder.encode(case).unwrap();
|
||||
let decoded = transcoder.decode(&encoded).unwrap();
|
||||
assert_eq!(case, decoded);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 6.2 トークン効率テスト
|
||||
```rust
|
||||
#[test]
|
||||
fn measure_token_reduction() {
|
||||
let encoder = tiktoken::get_encoding("cl100k_base");
|
||||
|
||||
let original = "box Cat from Animal { init { name } }";
|
||||
let ancp = "$Cat@Animal{#{name}}";
|
||||
|
||||
let original_tokens = encoder.encode(original).len();
|
||||
let ancp_tokens = encoder.encode(ancp).len();
|
||||
|
||||
let reduction = 1.0 - (ancp_tokens as f64 / original_tokens as f64);
|
||||
assert!(reduction >= 0.5); // 50%以上の削減を保証
|
||||
}
|
||||
```
|
||||
|
||||
### 6.3 エラー位置テスト
|
||||
```rust
|
||||
#[test]
|
||||
fn error_position_mapping() {
|
||||
let ancp = "$Test{invalid syntax here}";
|
||||
let result = transcoder.decode_with_map(ancp);
|
||||
|
||||
match result {
|
||||
Err(AncpError::InvalidSyntax { position, .. }) => {
|
||||
// エラー位置が正しくマッピングされているか
|
||||
assert_eq!(position.line, 1);
|
||||
assert_eq!(position.column, 14);
|
||||
}
|
||||
_ => panic!("Expected syntax error"),
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 7. パフォーマンス目標
|
||||
|
||||
### 7.1 変換性能
|
||||
- エンコード: 100MB/s以上
|
||||
- デコード: 150MB/s以上
|
||||
- メモリ使用: 入力サイズの2倍以内
|
||||
|
||||
### 7.2 実行時性能
|
||||
- パース時間増加: 10%以内
|
||||
- 実行時オーバーヘッド: なし（パース後は同一AST）
|
||||
|
||||
## 8. セキュリティ考慮事項
|
||||
|
||||
### 8.1 インジェクション対策
|
||||
- ANCP記号が既存コードを破壊しないよう検証
|
||||
- 文字列エスケープの適切な処理
|
||||
|
||||
### 8.2 バージョン互換性
|
||||
- 古いANCPバージョンの適切なエラー表示
|
||||
- 将来の拡張に備えた設計
|
||||
|
||||
## 9. 将来の拡張
|
||||
|
||||
### 9.1 ANCP v2.0候補
|
||||
- 文脈依存圧縮（頻出パターンの動的割当）
|
||||
- カスタム辞書サポート
|
||||
- バイナリ形式（BANCTP）
|
||||
|
||||
### 9.2 AI特化拡張
|
||||
- モデル別最適化プロファイル
|
||||
- トークナイザー直接統合
|
||||
- 意味保持圧縮
|
||||
|
||||
---
|
||||
|
||||
この仕様書は、ANCPの技術的実装の基準となる文書です。実装時はこの仕様に従い、必要に応じて更新してください。
|
||||
@ -1,16 +1,19 @@
|
||||
# Phase 12 Task Board (v2 - セルフホスティング対応)
|
||||
|
||||
Status: Tier-0 完了（vtable雛形 + レジストリ + VM優先経路）。次は Tier-1 の最小Nyash ABIサンプル実装へ。
|
||||
|
||||
目的: C ABI を壊さず、TypeBox + 統一ディスパッチで Nyash ABI を段階導入。MIR→VM→JIT を「綺麗な箱」で統一。**最終的にRust依存を排除し、セルフホスティングを実現。**
|
||||
|
||||
## Tier-0（直近・安全に積める）
|
||||
- [x] MapBoxの実用拡張（stringキー/便利API）
|
||||
- [x] `keys()/values()` ランタイムシム（現状は改行区切りString返却）
|
||||
- [ ] TypeBoxレジストリ（雛形）
|
||||
- Box名/FQN、type_id、メソッド表、returns_result を登録
|
||||
- 既存 `nyash.toml` → TypeBoxInfo への変換層
|
||||
- [ ] 統一ディスパッチ層（VM）
|
||||
- Nyash ABI vtable優先 → 無ければ C ABI（TLV）へフォールバック
|
||||
- 所有権・セーフポイントのガード（MAY_BLOCKのみ初期対応）
|
||||
- [x] `keys()/values()` 実装（ArrayBox返却に更新）
|
||||
- [x] TypeBoxレジストリ（雛形）
|
||||
- Box名/FQN、type_id、メソッド表（静的スロット）を登録（`src/runtime/type_registry.rs`）
|
||||
- 既存 `nyash.toml` → TypeBoxInfo 変換層は別途（未着手）
|
||||
- [x] 統一ディスパッチ層（VM・雛形）
|
||||
- `NYASH_ABI_VTABLE=1` で vtable優先のVM経路を有効化（fallbackはC ABI/TLV）。
|
||||
- Array/Map/String/Instance の主要メソッドを最小カバレッジで処理（`try_boxcall_vtable_stub`）。
|
||||
- 所有権・セーフポイントのガードは既存Barrier呼び出しで一部対応（MAY_BLOCK等は今後拡張）。
|
||||
- [x] プラグインテスター更新（v2ローダに対応）: `src/bin/test_plugin_loader_v2.rs`
|
||||
|
||||
## Tier-1（実証）
|
||||
@ -24,9 +27,8 @@
|
||||
- [ ] NyashValueインライン（i64/bool）の高速化
|
||||
- [ ] 例外/エラーの完全変換（panic→nyrt_err）
|
||||
- [ ] 所有権契約の遵守（TRANSFER/BORROW/CLONE）
|
||||
- [ ] `keys()/values()` の正式実装（ArrayBox返却）
|
||||
- 選択肢A: ランタイムで ArrayBox を構築
|
||||
- 選択肢B: Mapプラグインに KeysArrayBox を同梱（要設定追加）
|
||||
- [x] `keys()/values()` の正式実装（ArrayBox返却）
|
||||
- 採用: ランタイムで ArrayBox を構築（`src/boxes/map_box.rs`）
|
||||
|
||||
## Tier-3（セルフホスティング）🔥新規
|
||||
- [ ] Nyash ABI C実装の開始
|
||||
|
||||
@ -1,10 +1,10 @@
|
||||
# Phase 15: Nyashセルフホスティング - 71k→15k行への革命
|
||||
# Phase 15: Nyashセルフホスティング - 世界一美しい箱の完成
|
||||
|
||||
## 📋 概要
|
||||
|
||||
NyashでNyashコンパイラを書く、完全なセルフホスティングの実現フェーズ。
|
||||
内蔵Cranelift JITを活用し、外部コンパイラ依存から完全に解放される。
|
||||
**革命的成果：71,000行→15,000行（75%削減）**
|
||||
MIR 13命令の美しさを最大限に活かし、外部コンパイラ依存から完全に解放される。
|
||||
**究極の目標：80,000行→20,000行（75%削減）→ さらなる最適化へ**
|
||||
|
||||
## 🎯 フェーズの目的
|
||||
|
||||
@ -36,11 +36,26 @@ NyashでNyashコンパイラを書く、完全なセルフホスティングの
|
||||
|
||||
## 🔧 技術的アプローチ
|
||||
|
||||
### 内蔵Craneliftの利点
|
||||
### MIR 13命令の革命
|
||||
- **基本演算(5)**: Const, UnaryOp, BinOp, Compare, TypeOp
|
||||
- **メモリ(2)**: Load, Store
|
||||
- **制御(4)**: Branch, Jump, Return, Phi
|
||||
- **Box(1)**: BoxCall（すべての箱操作を統合）
|
||||
- **外部(1)**: ExternCall
|
||||
|
||||
この究極のシンプルさにより、直接x86変換も現実的に！
|
||||
|
||||
### バックエンドの選択肢
|
||||
#### 1. Cranelift（現在の主力）
|
||||
- **軽量**: 3-5MB程度（LLVMの1/10以下）
|
||||
- **JIT特化**: メモリ上での動的コンパイル
|
||||
- **Rust統合**: 静的リンクで配布容易
|
||||
|
||||
#### 2. 直接x86エミッタ（革新的アプローチ）
|
||||
- **dynasm-rs/iced-x86**: Rust内で直接アセンブリ生成
|
||||
- **テンプレート・スティッチャ方式**: 2-3KBの超小型バイナリ可能
|
||||
- **完全な制御**: 依存ゼロの究極形
|
||||
|
||||
### コード削減の秘密
|
||||
- **Arc<Mutex>自動化**: 明示的ロック管理不要（-30%）
|
||||
- **型システム簡略化**: 動的型付けの恩恵（-20%）
|
||||
@ -49,7 +64,7 @@ NyashでNyashコンパイラを書く、完全なセルフホスティングの
|
||||
|
||||
### 実装例
|
||||
```nyash
|
||||
// 71,000行のRust実装が...
|
||||
// 80,000行のRust実装が20,000行のNyashに！
|
||||
box NyashCompiler {
|
||||
init { parser, lowerer, backend }
|
||||
|
||||
@ -68,6 +83,34 @@ box MirExecutor {
|
||||
}
|
||||
```
|
||||
|
||||
### テンプレート・スティッチャ方式（革新的アプローチ）
|
||||
```nyash
|
||||
// 各MIR命令を共通スタブとして実装
|
||||
box TemplateStitcher {
|
||||
init { stubs }
|
||||
|
||||
constructor() {
|
||||
me.stubs = new MapBox()
|
||||
// 各命令の共通実装をスタブとして登録
|
||||
me.stubs.set("Const", 0x1000) // スタブアドレス
|
||||
me.stubs.set("BinOp", 0x1100)
|
||||
me.stubs.set("BoxCall", 0x1200)
|
||||
// ... 13命令分のスタブ
|
||||
}
|
||||
|
||||
generate(mir) {
|
||||
local jumps = new ArrayBox()
|
||||
|
||||
// プログラムはスタブ間のジャンプ列に！
|
||||
for inst in mir.instructions {
|
||||
jumps.push("jmp " + me.stubs.get(inst.type))
|
||||
}
|
||||
|
||||
return jumps // 超小型バイナリ！
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 🔗 EXEファイル生成・リンク戦略
|
||||
|
||||
### 段階的アプローチ
|
||||
@ -111,7 +154,18 @@ box MirExecutor {
|
||||
外部ツールチェーンに依存しない、真の自立したプログラミング言語へ。
|
||||
|
||||
### 数値で見る革命
|
||||
- **コード行数**: 71,000 → 15,000行（**75%削減**）
|
||||
- **理解容易性**: 1週間で読破可能なコンパイラ
|
||||
- **貢献しやすさ**: 誰でも改造できる規模
|
||||
- **教育的価値**: 世界一シンプルな実用コンパイラ
|
||||
- **現在**: 80,000行（Rust実装）
|
||||
- **第一目標**: 20,000行（Nyashセルフホスティング、**75%削減**）
|
||||
- **究極の夢**: さらなる最適化でより小さく！
|
||||
- **MIR命令数**: たった13個で全機能実現
|
||||
- **理解容易性**: 週末で読破可能なコンパイラ
|
||||
- **バイナリサイズ**: テンプレート方式なら2-3KBも可能
|
||||
- **教育的価値**: 世界一美しく、世界一小さい実用コンパイラ
|
||||
|
||||
### 🌟 Everything is Boxの究極形
|
||||
- コンパイラもBox
|
||||
- リンカーもBox
|
||||
- アセンブラもBox
|
||||
- すべてがBox！
|
||||
|
||||
**世界一美しい箱は、自分自身さえも美しく包み込む**
|
||||
@ -1,15 +1,22 @@
|
||||
================================================================================
|
||||
Phase 15: Nyashセルフホスティング計画 - 71k→15k行への革命的圧縮
|
||||
Phase 15: Nyashセルフホスティング計画 - 80k→20k行への革命的圧縮
|
||||
================================================================================
|
||||
|
||||
【ビジョン】
|
||||
NyashでNyashコンパイラを書き、Nyashプログラムをコンパイル・実行する
|
||||
完全なセルフホスティング環境の実現 + 劇的なコード圧縮（75%削減）
|
||||
MIR 13命令の美しさを最大限に活かした究極の実装
|
||||
|
||||
【数値目標】
|
||||
現在: 71,000行（Rust実装）
|
||||
目標: 15,000-20,000行（Nyash実装）
|
||||
削減率: 約75%
|
||||
現在: 80,000行（Rust実装）
|
||||
第一目標: 20,000行（Nyash実装）
|
||||
削減率: 75%
|
||||
究極の夢: さらなる最適化で更に小さく！
|
||||
|
||||
【革命的要素】
|
||||
MIR命令数: たった13個で全機能実現
|
||||
バックエンド選択: Cranelift/直接x86/テンプレート方式
|
||||
バイナリサイズ: 2-3KBの超小型も可能
|
||||
|
||||
================================================================================
|
||||
1. なぜセルフホスティングか + コード圧縮の価値
|
||||
@ -44,19 +51,26 @@ NyashでNyashコンパイラを書き、Nyashプログラムをコンパイル
|
||||
└─ 依存が少ない: ビルド時間短縮
|
||||
|
||||
■ 既存の準備状況
|
||||
├─ ✅ MIR 13命令に削減完了（究極のシンプルさ）
|
||||
├─ ✅ Cranelift統合準備済み（Cargo.toml）
|
||||
├─ ✅ MIR15確定（シンプルなIR）
|
||||
├─ ✅ 直接x86エミッタ選択肢（dynasm-rs/iced-x86）
|
||||
├─ ✅ プラグインシステム（拡張可能）
|
||||
└─ 🔄 Phase 10でJIT実装予定
|
||||
└─ ✅ Phase 12で統一実行パス確立
|
||||
|
||||
================================================================================
|
||||
3. 段階的実装計画 - ChatGPT5戦略による最速ルート
|
||||
================================================================================
|
||||
|
||||
■ Phase 15.0: YAML自動生成基盤（1-2週間）【最優先】
|
||||
■ Phase 15.0: バックエンド選択戦略（新規追加）
|
||||
├─ 選択肢1: Cranelift（現在の主力、安定）
|
||||
├─ 選択肢2: 直接x86エミッタ（dynasm-rs使用、高速）
|
||||
├─ 選択肢3: テンプレート・スティッチャ（2-3KB超小型）
|
||||
└─ 段階的移行: Cranelift→x86→テンプレート
|
||||
|
||||
■ Phase 15.1: YAML自動生成基盤（1-2週間）【最優先】
|
||||
├─ boxes.yaml: Box型定義（type_id, method_id対応表）
|
||||
├─ externs.yaml: 外部関数定義（C ABI境界）
|
||||
├─ semantics.yaml: MIR15セマンティクス定義
|
||||
├─ semantics.yaml: MIR13セマンティクス定義（13命令！）
|
||||
└─ build.rs: 自動生成システム（重複コード即削除）
|
||||
|
||||
効果: Array/Instance/Console等で即座に1-2万行削減
|
||||
@ -181,21 +195,26 @@ box MiniLinkerBox {
|
||||
├─ 真の「Everything is Box」体験
|
||||
└─ コントリビューション容易化
|
||||
|
||||
■ コード削減の具体例
|
||||
├─ Boxes実装: 11,153行 → 2,000行（80%削減）
|
||||
├─ Interpreter: 11,278行 → 3,000行（73%削減）
|
||||
├─ MIR: 10,918行 → 2,500行（77%削減）
|
||||
├─ Parser: 2,680行 → 800行（70%削減）
|
||||
└─ Backend: 9,196行 → 3,000行（67%削減）
|
||||
■ コード削減の具体例（80k→20k）
|
||||
├─ Boxes実装: 13,000行 → 3,000行（77%削減）
|
||||
├─ Interpreter: 15,000行 → 4,000行（73%削減）
|
||||
├─ MIR: 12,000行 → 2,000行（83%削減、13命令化の効果）
|
||||
├─ Parser: 5,000行 → 1,500行（70%削減）
|
||||
├─ Backend: 15,000行 → 4,000行（73%削減）
|
||||
└─ その他: 20,000行 → 5,500行（72%削減）
|
||||
|
||||
================================================================================
|
||||
7. 成功指標
|
||||
================================================================================
|
||||
|
||||
□ NyashコンパイラがNyash自身をコンパイル可能
|
||||
□ コード行数: 15,000-20,000行以内（75%削減達成）
|
||||
□ コード行数: 20,000行以内（75%削減達成）
|
||||
□ MIR 13命令での完全実装
|
||||
□ 性能: Rustコンパイラの50%以上
|
||||
□ バイナリサイズ: 10MB以下（Cranelift込み）
|
||||
□ バイナリサイズ:
|
||||
- Cranelift版: 10MB以下
|
||||
- 直接x86版: 5MB以下
|
||||
- テンプレート版: 1MB以下（夢の2-3KBも視野）
|
||||
□ コンパイル時間: 中規模プロジェクトで10秒以内
|
||||
□ 100%のテストケース互換性
|
||||
□ trace_hash/heap_hashパリティ（VM/JIT/AOT）
|
||||
|
||||
@ -13,11 +13,12 @@ NyashCompiler (Nyashで実装)
|
||||
├── Middle-end
|
||||
│ ├── Type Checker
|
||||
│ ├── Name Resolver
|
||||
│ ├── MIR Lowerer
|
||||
│ ├── MIR Lowerer (→13命令)
|
||||
│ └── Optimizer
|
||||
└── Backend
|
||||
└── Backend（複数選択可能）
|
||||
├── CraneliftBox (JITラッパー)
|
||||
├── Code Generator
|
||||
├── X86EmitterBox (直接エミッタ)
|
||||
├── TemplateStitcherBox (超小型)
|
||||
└── Runtime Linker
|
||||
```
|
||||
|
||||
@ -204,7 +205,7 @@ box MIRLowerer {
|
||||
}
|
||||
```
|
||||
|
||||
## 4. Cranelift統合
|
||||
## 4. バックエンド実装
|
||||
|
||||
### 4.1 CraneliftBox実装
|
||||
|
||||
@ -244,6 +245,107 @@ box CraneliftBox {
|
||||
}
|
||||
```
|
||||
|
||||
### 4.2 X86EmitterBox実装（直接x86生成）
|
||||
|
||||
```nyash
|
||||
box X86EmitterBox {
|
||||
init { code_buffer, label_map }
|
||||
|
||||
constructor() {
|
||||
me.code_buffer = new ArrayBox()
|
||||
me.label_map = new MapBox()
|
||||
}
|
||||
|
||||
compile(mir) {
|
||||
// MIR 13命令を直接x86-64に変換！
|
||||
for func in mir.functions {
|
||||
me.emitFunction(func)
|
||||
}
|
||||
|
||||
return me.code_buffer
|
||||
}
|
||||
|
||||
emitInstruction(inst) {
|
||||
// MIR命令をx86テンプレートに変換
|
||||
if inst.type == "Const" {
|
||||
// mov rax, imm64
|
||||
me.emit_mov_imm(inst.dst, inst.value)
|
||||
}
|
||||
|
||||
if inst.type == "BinOp" {
|
||||
if inst.op == "Add" {
|
||||
// add rax, rbx
|
||||
me.emit_add(inst.dst, inst.left, inst.right)
|
||||
}
|
||||
}
|
||||
|
||||
if inst.type == "BoxCall" {
|
||||
// mov rdi, receiver
|
||||
// mov rax, [rdi] ; vtable
|
||||
// call [rax+slot*8] ; method call
|
||||
me.emit_boxcall(inst.recv, inst.slot)
|
||||
}
|
||||
|
||||
// ... 残り10命令のテンプレート
|
||||
}
|
||||
|
||||
emit_mov_imm(reg, value) {
|
||||
// REX.W + mov r64, imm64
|
||||
me.code_buffer.push(0x48) // REX.W
|
||||
me.code_buffer.push(0xB8 + reg) // mov opcode
|
||||
|
||||
// 64ビット即値をリトルエンディアンで
|
||||
for i in range(0, 8) {
|
||||
me.code_buffer.push((value >> (i * 8)) & 0xFF)
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 4.3 テンプレート・スティッチャ実装（超小型バイナリ）
|
||||
|
||||
```nyash
|
||||
box TemplateStitcherBox {
|
||||
init { stub_addresses, jump_table }
|
||||
|
||||
constructor() {
|
||||
// 各MIR命令の共通スタブアドレス
|
||||
me.stub_addresses = new MapBox()
|
||||
me.stub_addresses.set("Const", 0x1000)
|
||||
me.stub_addresses.set("UnaryOp", 0x1100)
|
||||
me.stub_addresses.set("BinOp", 0x1200)
|
||||
me.stub_addresses.set("Compare", 0x1300)
|
||||
me.stub_addresses.set("TypeOp", 0x1400)
|
||||
me.stub_addresses.set("Load", 0x1500)
|
||||
me.stub_addresses.set("Store", 0x1600)
|
||||
me.stub_addresses.set("Branch", 0x1700)
|
||||
me.stub_addresses.set("Jump", 0x1800)
|
||||
me.stub_addresses.set("Return", 0x1900)
|
||||
me.stub_addresses.set("Phi", 0x1A00)
|
||||
me.stub_addresses.set("BoxCall", 0x1B00)
|
||||
me.stub_addresses.set("ExternCall", 0x1C00)
|
||||
}
|
||||
|
||||
compile(mir) {
|
||||
me.jump_table = new ArrayBox()
|
||||
|
||||
// プログラムはスタブへのジャンプ列として表現
|
||||
for inst in mir.instructions {
|
||||
local stub_addr = me.stub_addresses.get(inst.type)
|
||||
|
||||
// jmp rel32
|
||||
me.jump_table.push(0xE9) // jmp opcode
|
||||
me.jump_table.push_rel32(stub_addr)
|
||||
|
||||
// 命令固有のパラメータをデータセクションに配置
|
||||
me.encodeParameters(inst)
|
||||
}
|
||||
|
||||
return me.jump_table
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 5. ブートストラップ手順
|
||||
|
||||
### 5.1 段階的移行
|
||||
|
||||
Reference in New Issue
Block a user